Man Linux: Main Page and Category List


       ample.conf - configuration file for Ample


       This  file,  by  default  /etc/ample/ample.conf,  is  read  by Ample at
       startup. There are three categories of  values  than  can  be  defined:
       strings,  numbers  and  boolean  values. Valid boolean values are (case
       insensitive) yes, no, true and false.  Lines  that  start  with  #  are
       considered to be comments and ignored.


              # An example of a Ample config file

              # Port number to use
              port = 1234

              # Should files be ordered when playing a mixed stream?
              order = true

              # Amount of simultaneous clients allowed
              clients = 5

              # Path to logfile if syslog isn’t used
              logfile = /var/log/ample

              # Path(s) to MP3 dir/file or M3U file
              mp3path = /home/mp3
              mp3path = /home/moremp3/zztop.mp3
              mp3path = /home/favourites.m3u

              # Path to the HTML file to use as a template
              htmlfile = /etc/ample.html

              # Should the MP3 dir(s) be recursively scanned?
              recursive = true

              # Name of the server
              # (displayed to clients here and there)
              servername = Ample

              # Address of the server
              # (only if your server can’t be resolved)
              serveraddress =

              # Username and password, if these are specified, Ample
              # will automatically ask for username/password
              username = MusicLover
              password = Pekaboo

              # Filter to pass each music file through
              # (before they are sent to the client)
              filter = /usr/bin/lame -b64 --quiet "@FPATH@" -

              # The end


              Listen to TCP port NUM, default is 1234.

              When a list of files is requested, and this option is TRUE, play
              them in alphabetical order.

              Allow a maximum of NUM clients to be connected at the same time.

              Use FILE as logfile if syslogd(8) isn’t used.

              These  are path(s) to files or directories that Ample can use to
              populate it’s list of MP3’s. If PATH is a directory,  all  files
              (possibly  recursively,  see the -n option above) will be added.
              If PATH is a regular file ending with .mp3 it will be added  and
              if  it  is  a  regular  file ending with .m3u (MP3 playlist) the
              files listed in it will be added. You can specify several  paths
              by adding several mp3path=PATH lines to this config file.

              This is the path to the file which Ample should use as it’s base
              for creating HTML pages. See ample.html(5) for more information.

              If  TRUE,  all  directories  that Ample index:es will be scanned
              recursively (meaning that all subdirs will be checked for  files
              as well)

              The  name of the server will be set to STRING instead of "Ample"
              (the servername is displayed to clients in various places).

              STRING should be the IP address of the  server  where  Ample  is
              run.  This is only needed if DNS resolving your server, for some
              reason, doesn’t work.

              If both username and password is specified in the  config  file,
              HTTP authentication will be enabled. This means that if a client
              wants to connect to ample, it must do so with  a  username   and
              password in order to be granted acccess. If username or password
              is missing, HTTP authentication will be disabled.

              See the description of username above.

              Specifies an optional filter to run each file through before  it
              is  sent  to  the  client.  As an example, this could be used to
              downgrade the bitrate of a music file if you have  a  lousy  net
              connection  but  lots of CPU cycles to spare. If STRING contains
              the word @FPATH@ it will be replaced with the absolute  path  of
              the file.


       David Härdeman <>


       ample(1), ample.html(5)