Provided by: ample_0.5.7-13_amd64 bug


       ample.conf - configuration file for Ample


       This  file,  by  default  /etc/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  access.  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)