Man Linux: Main Page and Category List

NAME

       ample.conf - configuration file for Ample

DESCRIPTION

       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.

EXAMPLE

              # 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 = 192.168.0.1

              # 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

OPTIONS

       port=NUM
              Listen to TCP port NUM, default is 1234.

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

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

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

       mp3path=PATH
              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.

       htmlfile=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.

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

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

       serveraddress=STRING
              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.

       username=STRING
              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.

       password=STRING
              See the description of username above.

       filter=STRING
              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.

AUTHOR

       David Härdeman <david@2gen.com>

SEE ALSO

       ample(1), ample.html(5)