From 4e05a161e54fe05902b99eff521aa0759b102f05 Mon Sep 17 00:00:00 2001 From: "J. Alexander Treuman" Date: Mon, 28 May 2007 15:50:45 +0000 Subject: Making branch for 0.13.0 fixes. git-svn-id: https://svn.musicpd.org/mpd/branches/branch-0.13.0-fixes@6330 09075e82-0dd4-0310-85a5-a0d7c8717e4f --- trunk/doc/mpd.conf.5 | 387 --------------------------------------------------- 1 file changed, 387 deletions(-) delete mode 100644 trunk/doc/mpd.conf.5 (limited to 'trunk/doc/mpd.conf.5') diff --git a/trunk/doc/mpd.conf.5 b/trunk/doc/mpd.conf.5 deleted file mode 100644 index efe95167d..000000000 --- a/trunk/doc/mpd.conf.5 +++ /dev/null @@ -1,387 +0,0 @@ -.TH mpd.conf 5 -.SH NAME -mpd.conf \- Music Player Daemon configuration file -.SH DESCRIPTION -\fBmpd.conf\fP is the configuration file for mpd(1). If not specified on the -command line, MPD first searches for it at \fB~/.mpdconf\fP and then in -\fB/etc/mpd.conf\fP. - -Lines beginning with a "#" character are comments. All other non-empty lines -specify parameters and their values. These lines contain the parameter name -and parameter value (surrounded by double quotes) separated by whitespace -(either tabs or spaces). For example: - -parameter "value" - -The exception to this rule is the audio_output parameter, which is of the form: - -audio_output { -.br - parameter1 "value" - parameter2 "value" -.br -} - -Parameters that take a file or directory as an argument should use absolute -paths. - -See \fBdocs/mpdconf.example\fP in the source tarball for an example -configuration file. -.SH REQUIRED PARAMETERS -.TP -.B music_directory -This specifies the directory where music is located. -.TP -.B playlist_directory -This specifies the directory where saved playlists are stored. -.TP -.B db_file -This specifies where the db file will be stored. -.TP -.B log_file -This specifies where the log file should be located. -.TP -.B error_file -This specifies where the error file should be located. -.SH OPTIONAL PARAMETERS -.TP -.B pid_file -This specifies the file to save mpd's process ID in. -.TP -.B state_file -This specifies if a state file is used and where it is located. The state of -mpd will be saved to this file when mpd is terminated by a TERM signal or by -the "kill" command. When mpd is restarted, it will read the state file and -restore the state of mpd (including the playlist). -.TP -.B user -This specifies the user that mpd will run as, if set. -.TP -.B bind_to_address -This specifies which address mpd binds to and listens on. Multiple -bind_to_address parameters may be specified. The default is "any", which binds -to all available addresses. -.TP -.B port -This specifies the port that mpd listens on. The default is 6600. -.TP -.B log_level -This specifies how verbose logs are. "default" is minimal logging, "secure" -reports from what address a connection is opened, and when it is closed, and -"verbose" records excessive amounts of information for debugging purposes. The -default is "default". -.TP -.B zeroconf_name -If Zerconf is compiled into MPD, this is the service name to publish. This -should be unique to your local network, but name collisions will be properly -dealt with. -.TP -.B password -This specifies a password for access to mpd. The format is -"password@permissions" where permissions is a comma delimited list composed -of "read", "add", "control", and/or "admin". "read" allows for reading of the -database, displaying the current playlist, and current status of mpd. "add" -allows for adding songs and loading playlists. "control" allows for all other -player and playlist manipulations. "admin" allows the db to be updated and for -the client to kill mpd. An example value is "somePassword@read,add". Multiple -password parameters may be specified. -.TP -.B default_permissions -This specifies the permissions of a client that has not been authenticated -using a password. The format of permissions is specified in the description of -the "password" config parameter. If no passwords are specified, the default is -"read,add,control,admin", otherwise it is "" (no permissions). -.TP -.B audio_output -See \fBDESCRIPTION\fP and the various \fBAUDIO OUTPUT PARAMETERS\fP sections -for the format of this parameter. Multiple audio_output sections may be -specified. If no audio_output section is specified, then MPD will scan for a -usable audio output. -.TP -.B audio_output_format -This specifies the sample rate, bits per sample, and number of channels of -audio that is sent to each audio output. Note that audio outputs may specify -their own audio format which will be used for actual output to the audio -device. An example is "44100:16:2" for 44100Hz, 16 bits, and 2 channels. The -default is to use the audio format of the input file. -.TP -.B samplerate_converter -This specifies the libsamplerate converter to use. The supplied value should -either be an integer or a prefix of the name of a converter. The default is -"Fastest Sinc Interpolator". - -At the time of this writing, the following converters are available: -.RS -.TP -Best Sinc Interpolator (0) - -Band limited sinc interpolation, best quality, 97dB SNR, 96% BW. -.TP -Medium Sinc Interpolator (1) - -Band limited sinc interpolation, medium quality, 97dB SNR, 90% BW. -.TP -Fastest Sinc Interpolator (2) - -Band limited sinc interpolation, fastest, 97dB SNR, 80% BW. -.TP -ZOH Interpolator (3) - -Zero order hold interpolator, very fast, very poor quality with audible -distortions. -.TP -Linear Interpolator (4) - -Linear interpolator, very fast, poor quality. -.RE -.IP -For an up-to-date list of available converters, please see the libsamplerate -documentation (available online at <\fBhttp://www.mega-nerd.com/SRC/\fP>). -.TP -.B mixer_type -This specifies which mixer to use. The default depends on what audio output -support mpd was built with. -.TP -.B mixer_device -This specifies which mixer to use. The default for oss is "/dev/mixer"; the -default for alsa is "default". -.TP -.B mixer_control -This specifies which mixer control to use (sometimes referred to as the -"device"). Examples of mixer controls are PCM, Line1, Master, etc. An example -for OSS is "Pcm", and an example for alsa is "PCM". -.TP -.B replaygain -If specified, mpd will adjust the volume of songs played using ReplayGain tags -(see <\fBhttp://www.replaygain.org/\fP>). Setting this to "album" will adjust -volume using the album's ReplayGain tags, while setting it to "track" will -adjust it using the track ReplayGain tags. Currently only FLAC, Ogg Vorbis, -Musepack, and MP3 (through ID3v2 ReplayGain tags, not APEv2) are supported. -.TP -.B replaygain_preamp <-15 to 15> -This is the gain (in dB) applied to songs with ReplayGain tags. -.TP -.B volume_normalization -If yes, mpd will normalize the volume of songs as they play. The default is no. -.TP -.B audio_buffer_size -This specifies the size of the audio buffer in kibibytes. The default is 2048, -large enough for nearly 12 seconds of CD-quality audio. -.TP -.B buffer_before_play <0-100%> -This specifies how much of the audio buffer should be filled before playing a -song. Try increasing this if you hear skipping when manually changing songs. -The default is 10%, a little over 1 second of CD-quality audio with the default -buffer size. -.TP -.B http_buffer_size -This specifies the size of the buffer used for playing HTTP streams. The -default is 128. -.TP -.B http_prebuffer_size -This specifies how much of an HTTP stream should be buffered before beginning -playback. The default is 32. -.TP -.B http_proxy_host -Use to specify the proxy host used for HTTP connections. -.TP -.B http_proxy_port -The port that the HTTP proxy host uses. -.TP -.B http_proxy_user -If the HTTP proxy server requires authentication, this specifies the username. -.TP -.B http_proxy_password -If the HTTP proxy server requires authentication, this specifies the password. -.TP -.B connection_timeout -If a client does not send any new data in this time period, the connection is -closed. The default is 60. -.TP -.B max_connections -This specifies the maximum number of clients that can be connected to mpd. The -default is 5. -.TP -.B max_playlist_length -This specifies the maximum number of songs that can be in the playlist. The -default is 4096. -.TP -.B max_command_list_size -This specifies the maximum size a command list can be. The default is 2048. -.TP -.B max_output_buffer_size -This specifies the maximum size of the output buffer to a client. The default -is 8192. -.TP -.B filesystem_charset -This specifies the character set used for the filesystem. A list of supported -character sets can be obtained by running "iconv -l". The default is -determined from the locale when the db was originally created. -.TP -.B id3v1_encoding -This specifies the character set which ID3v1 tags are encoded in. A list of -supported character sets can be obtained by running "iconv -l". The default is -to let libid3tag convert them (from ISO-8859-1, as the standard specifies) and -do no additional conversion. -.TP -.B gapless_mp3_playback -This specifies whether to support gapless playback of MP3s which have the -necessary headers. Useful if your MP3s have headers with incorrect -information. If you have such MP3s, it is highly recommended that you fix them -using vbrfix (available from ) -instead of disabling gapless MP3 playback. The default is to support gapless -MP3 playback. -.TP -.B save_absolute_paths_in_playlists -This specifies whether relative or absolute paths for song filenames are used -when saving playlists. The default is "no". -.TP -.B metadata_to_use -This specifies the tag types that will be scanned for and made available to -clients. Note that you must recreate (not update) your database for changes to -this parameter to take effect. Possible values are artist, album, title, -track, name, genre, date, composer, performer, comment, and disc. Multiple -tags may be specified as a comma separated list. An example value is -"artist,album,title,track". The special value "none" may be used alone to -disable all metadata. The default is to use all known tag types except for -comments. -.SH REQUIRED AUDIO OUTPUT PARAMETERS -.TP -.B type -This specifies the audio output type. See the list of supported outputs in mpd ---version for possible values. -.TP -.B name -This specifies a unique name for the audio output. -.SH OPTIONAL AUDIO OUTPUT PARAMETERS -.TP -.B format -This specifies the sample rate, bits per sample, and number of channels of -audio that is sent to the audio output device. See documentation for the -\fBaudio_output_format\fP parameter for more details. The default is to use -whatever audio format is passed to the audio output. -.SH OPTIONAL ALSA OUTPUT PARAMETERS -.TP -.B device -This specifies the device to use for audio output. The default is "default". -.TP -.B use_mmap -Setting this allows you to use memory-mapped I/O. Certain hardware setups may -benefit from this, but most do not. Most users do not need to set this. The -default is to not use memory-mapped I/O. -.TP -.B buffer_time