GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AMPLE.CONF (5)

NAME

ample.conf - configuration file for Ample

CONTENTS

Description
Example
Options
Author

DESCRIPTION

This file, by default /usr/local/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.

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)
Search for    or go to Top of page |  Section 5 |  Main Index


Ample AMPLE.CONF (5) JANUARY 2002

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.