diff options
Diffstat (limited to 'audio-players/mpd/init.d/mpd.conf')
-rw-r--r-- | audio-players/mpd/init.d/mpd.conf | 424 |
1 files changed, 274 insertions, 150 deletions
diff --git a/audio-players/mpd/init.d/mpd.conf b/audio-players/mpd/init.d/mpd.conf index 2f6d22accb..9193262362 100644 --- a/audio-players/mpd/init.d/mpd.conf +++ b/audio-players/mpd/init.d/mpd.conf @@ -1,245 +1,369 @@ # An example configuration file for MPD # See the mpd.conf man page for a more detailed description of each parameter. -######################## REQUIRED PATHS ######################## -music_directory "/var/lib/mpd/music" -playlist_directory "/var/lib/mpd/playlists" -db_file "/var/lib/mpd/mpd.db" -log_file "/var/log/mpd.log" -error_file "/var/log/mpd.error" -################################################################ + +# Files and directories ####################################################### +# +# This setting controls the top directory which MPD will search to discover the +# available audio files and add them to the daemon's online database. This +# setting defaults to the XDG directory, otherwise the music directory will be +# be disabled and audio files will only be accepted over ipc socket (using +# file:// protocol) or streaming files over an accepted protocol. +# +#music_directory "~/music" +# +# This setting sets the MPD internal playlist directory. The purpose of this +# directory is storage for playlists created by MPD. The server will use +# playlist files not created by the server but only if they are in the MPD +# format. This setting defaults to playlist saving being disabled. +# +#playlist_directory "~/.mpd/playlists" +# +# This setting sets the location of the MPD database. This file is used to +# load the database at server start up and store the database while the +# server is not up. This setting defaults to disabled which will allow +# MPD to accept files over ipc socket (using file:// protocol) or streaming +# files over an accepted protocol. +# +#db_file "~/.mpd/database" +# +# These settings are the locations for the daemon log files for the daemon. +# These logs are great for troubleshooting, depending on your log_level +# settings. +# +# The special value "syslog" makes MPD use the local syslog daemon. This +# setting defaults to logging to syslog, otherwise logging is disabled. +# +#log_file "~/.mpd/log" +# +# This setting sets the location of the file which stores the process ID +# for use of mpd --kill and some init scripts. This setting is disabled by +# default and the pid file will not be stored. +# +#pid_file "~/.mpd/pid" +# +# This setting sets the location of the file which contains information about +# most variables to get MPD back into the same general shape it was in before +# it was brought down. This setting is disabled by default and the server +# state will be reset on server start up. +# +#state_file "~/.mpd/state" +# +############################################################################### -######################## OPTIONAL PATHS ######################## +# General music daemon options ################################################ # -# If you wish to use mpd --kill to stop MPD, then you must -# specify a file here in which to store MPD's process ID. +# This setting specifies the user that MPD will run as. MPD should never run as +# root and you may use this setting to make MPD change its user ID after +# initialization. This setting is disabled by default and MPD is run as the +# current user. # -#pid_file "~/.mpd/mpd.pid" +#user "nobody" # -# If specified, MPD will save its current state (playlist, -# current song, playing/paused, etc.) at exit. This will be -# used to restore the session the next time it is run. +# This setting sets the address for the daemon to listen on. Careful attention +# should be paid if this is assigned to anything other then the default, any. +# This setting can deny access to control of the daemon. # -#state_file "~/.mpd/mpdstate" +# For network +#bind_to_address "any" # -################################################################ +# And for Unix Socket +#bind_to_address "~/.mpd/socket" +# +# This setting is the TCP port that is desired for the daemon to get assigned +# to. +# +#port "6600" +# +# This setting controls the type of information which is logged. Available +# setting arguments are "default", "secure" or "verbose". The "verbose" setting +# argument is recommended for troubleshooting, though can quickly stretch +# available resources on limited hardware storage. +# +#log_level "default" +# +# If you have a problem with your MP3s ending abruptly it is recommended that +# you set this argument to "no" to attempt to fix the problem. If this solves +# the problem, it is highly recommended to fix the MP3 files with vbrfix +# (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which +# point gapless MP3 playback can be enabled. +# +#gapless_mp3_playback "yes" +# +# This setting enables MPD to create playlists in a format usable by other +# music players. +# +#save_absolute_paths_in_playlists "no" +# +# This setting defines a list of tag types that will be extracted during the +# audio file discovery process. Optionally, 'comment' can be added to this +# list. +# +#metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc" +# +############################################################################### -######################## DAEMON OPTIONS ######################## +# Symbolic link behavior ###################################################### # -# If started as root, MPD will drop root privileges and run as -# this user instead. Otherwise, MPD will run as the user it was -# started by. If left unspecified, MPD will not drop root -# privileges at all (not recommended). +# If this setting is set to "yes", MPD will discover audio files by following +# symbolic links outside of the configured music_directory. # -user "musicdaemon" +#follow_outside_symlinks "yes" # -# The address and port to listen on. +# If this setting is set to "yes", MPD will discover audio files by following +# symbolic links inside of the configured music_directory. # -bind_to_address "any" -port "6600" +#follow_inside_symlinks "yes" # -# Controls the amount of information that is logged. Can be -# "default", "secure", or "verbose". +############################################################################### + + +# Zeroconf / Avahi Service Discovery ########################################## # -log_level "default" +# If this setting is set to "yes", service information will be published with +# Zeroconf / Avahi. # -################################################################ +#zeroconf_enabled "yes" +# +# The argument to this setting will be the Zeroconf / Avahi unique name for +# this MPD server on the network. +# +#zeroconf_name "Music Player" +# +############################################################################### -########################## PERMISSIONS ######################### +# Permissions ################################################################# # -# MPD can require that users specify a password before using it. -# You may specify one ore more here, along with what users who -# log in with that password are allowed to do. +# If this setting is set, MPD will require password authorization. The password +# can setting can be specified multiple times for different password profiles. # #password "password@read,add,control,admin" # -# Specifies what permissions a user who has not logged in with a -# password has. By default, all users have full access to MPD -# if no password is specified above, or no access if one or -# more passwords are specified. +# This setting specifies the permissions a user has who has not yet logged in. # #default_permissions "read,add,control,admin" # -################################################################ +############################################################################### -########################## AUDIO OUTPUT ######################## +# Input ####################################################################### # -# MPD supports many audio output types, as well as playing -# through multiple audio outputs at the same time. You can -# specify one or more here. If you don't specify any, MPD will -# automatically scan for a usable audio output. + +input { + plugin "curl" +# proxy "proxy.isp.com:8080" +# proxy_user "user" +# proxy_password "password" +} + +# +############################################################################### + +# Audio Output ################################################################ # -# See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> -# for examples of other audio outputs. +# MPD supports various audio output types, as well as playing through multiple +# audio outputs at the same time, through multiple audio_output settings +# blocks. Setting this block is optional, though the server will only attempt +# autodetection for one sound card. +# +# See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of +# other audio outputs. # # An example of an ALSA output: # #audio_output { -# type "alsa" -# name "My ALSA Device" -# device "hw:0,0" # optional -# format "44100:16:2" # optional +# type "alsa" +# name "My ALSA Device" +# device "hw:0,0" # optional +# format "44100:16:2" # optional +# mixer_device "default" # optional +# mixer_control "PCM" # optional +# mixer_index "0" # optional #} # # An example of an OSS output: # #audio_output { -# type "oss" -# name "My OSS Device" -# device "/dev/dsp" # optional -# format "44100:16:2" # optional +# type "oss" +# name "My OSS Device" +# device "/dev/dsp" # optional +# format "44100:16:2" # optional +# mixer_device "/dev/mixer" # optional +# mixer_control "PCM" # optional #} # # An example of a shout output (for streaming to Icecast): # #audio_output { -# type "shout" -# name "My Shout Stream" -# host "localhost" -# port "8000" -# mount "/mpd.ogg" -# password "hackme" -# quality "5.0" -# bitrate "128" -# format "44100:16:1" -# user "source" # optional -# description "My Stream Description" # optional -# genre "jazz" # optional -# public "no" # optional +# type "shout" +# encoding "ogg" # optional +# name "My Shout Stream" +# host "localhost" +# port "8000" +# mount "/mpd.ogg" +# password "hackme" +# quality "5.0" +# bitrate "128" +# format "44100:16:1" +# protocol "icecast2" # optional +# user "source" # optional +# description "My Stream Description" # optional +# genre "jazz" # optional +# public "no" # optional +# timeout "2" # optional #} # -# Force all decoded audio to be converted to this format before -# being passed to the audio outputs. +# An example of a httpd output (built-in HTTP streaming server): +# +#audio_output { +# type "httpd" +# name "My HTTP Stream" +# encoder "vorbis" # optional, vorbis or lame +# port "8000" +# quality "5.0" # do not define if bitrate is defined +# bitrate "128" # do not define if quality is defined +# format "44100:16:1" +#} # -#audio_output_format "44100:16:2" +# An example of a pulseaudio output (streaming to a remote pulseaudio server) # -################################################################ - - -############################# MIXER ############################ +#audio_output { +# type "pulse" +# name "My Pulse Output" +# server "remote_server" # optional +# sink "remote_server_sink" # optional +#} # -# MPD needs to know what mixer settings to change when you -# adjust the volume. If you don't specify one here, MPD will -# pick one based on which ones it was compiled with support for. +## Example "pipe" output: # -# An example for controlling an ALSA mixer: +#audio_output { +# type "pipe" +# name "my pipe" +# command "aplay -f cd 2>/dev/null" +## Or if you're want to use AudioCompress +# command "AudioCompress -m | aplay -f cd 2>/dev/null" +## Or to send raw PCM stream through PCM: +# command "nc example.org 8765" +# format "44100:16:2" +#} # -#mixer_type "alsa" -#mixer_device "default" -#mixer_control "PCM" +## An example of a null output (for no audio output): +# +#audio_output { +# type "null" +# name "My Null Output" +#} # -# An example for controlling an OSS mixer: +# This setting will change all decoded audio to be converted to the specified +# format before being passed to the audio outputs. By default, this setting is +# disabled. # -#mixer_type "oss" -#mixer_device "/dev/mixer" -#mixer_control "PCM" +#audio_output_format "44100:16:2" # -# If you want MPD to adjust the volume of audio sent to the -# audio outputs, you can tell it to use the software mixer: +# If MPD has been compiled with libsamplerate support, this setting specifies +# the sample rate converter to use. Possible values can be found in the +# mpd.conf man page or the libsamplerate documentation. By default, this is +# setting is disabled. # -#mixer_type "software" +#samplerate_converter "Fastest Sinc Interpolator" # -################################################################ +############################################################################### -######################### NORMALIZATION ######################## +# Volume control mixer ######################################################## # -# Specifies the type of ReplayGain to use. Can be "album" or -# "track". ReplayGain will not be used if not specified. See -# <http://www.replaygain.org> for more details. +# These are the global volume control settings. By default, this setting will +# be detected to the available audio output device, with preference going to +# hardware mixing. Hardware and software mixers for individual audio_output +# sections cannot yet be mixed. # -#replaygain "album" +# An example for controlling an ALSA, OSS or Pulseaudio mixer; If this +# setting is used other sound applications will be affected by the volume +# being controlled by MPD. # -# Sets the pre-amp used for files that have ReplayGain tags. +#mixer_type "hardware" # -#replaygain_preamp "0" +# An example for controlling all mixers through software. This will control +# all controls, even if the mixer is not supported by the device and will not +# affect any other sound producing applications. # -# Enable on the fly volume normalization. This will cause the -# volume of all songs played to be adjusted so that they sound -# as though they are of equal loudness. +#mixer_type "software" # -#volume_normalization "no" +# This example will not allow MPD to touch the mixer at all and will disable +# all volume controls. # -################################################################ +#mixer_type "disabled" +# +############################################################################### -########################### BUFFERING ########################## +# Normalization automatic volume adjustments ################################## # -# The size of the buffer containing decoded audio. You probably -# shouldn't change this. +# This setting specifies the type of ReplayGain to use. This setting can have +# the argument "album" or "track". See <http://www.replaygain.org> for more +# details. This setting is disabled by default. # -#audio_buffer_size "2048" +#replaygain "album" # -# How much of the buffer to fill before beginning to play. +# This setting sets the pre-amp used for files that have ReplayGain tags. By +# default this setting is disabled. # -#buffer_before_play "0%" +#replaygain_preamp "0" # -# Similar options for the HTTP stream buffer. If you hear -# skipping while playing HTTP streams, you may wish to increase -# these. +# This setting enables on-the-fly normalization volume adjustment. This will +# result in the volume of all playing audio to be adjusted so the output has +# equal "loudness". This setting is disabled by default. # -#http_buffer_size "128" -#http_prebuffer_size "25%" +#volume_normalization "no" # -################################################################ +############################################################################### -########################### HTTP PROXY ######################### -# -# Specifies the HTTP proxy to use for playing HTTP streams. +# MPD Internal Buffering ###################################################### # -#http_proxy_host "proxy.isp.com" -#http_proxy_port "8080" -#http_proxy_user "user" -#http_proxy_password "password" +# This setting adjusts the size of internal decoded audio buffering. Changing +# this may have undesired effects. Don't change this if you don't know what you +# are doing. # -################################################################ - - -############################# LIMITS ########################### +#audio_buffer_size "2048" # -# These are various limits to prevent MPD from using too many -# resources. You should only change them if they start -# restricting your usage of MPD. +# This setting controls the percentage of the buffer which is filled before +# beginning to play. Increasing this reduces the chance of audio file skipping, +# at the cost of increased time prior to audio playback. # -#connection_timeout "60" -#max_connections "5" -#max_playlist_length "16384" -#max_command_list_size "2048" -#max_output_buffer_size "8192" +#buffer_before_play "10%" # -################################################################ +############################################################################### -###################### CHARACTER ENCODINGS ##################### -# -# If file or directory names do not display correctly, then you -# may need to change this. In most cases it should be either -# "ISO-8859-1" or "UTF-8". You must recreate your database -# after changing this (use mpd --create-db). -# -#filesystem_charset "ISO-8859-1" +# Resource Limitations ######################################################## # -# The encoding that ID3v1 tags should be converted from. +# These settings are various limitations to prevent MPD from using too many +# resources. Generally, these settings should be minimized to prevent security +# risks, depending on the operating resources. # -#id3v1_encoding "ISO-8859-1" +#connection_timeout "60" +#max_connections "10" +#max_playlist_length "16384" +#max_command_list_size "2048" +#max_output_buffer_size "8192" # -################################################################ +############################################################################### -######################### OTHER OPTIONS ######################## +# Character Encoding ########################################################## # -# The metadata types MPD will recognize. +# If file or directory names do not display correctly for your locale then you +# may need to modify this setting. After modification of this setting mpd +# --create-db must be run to change the database. # -#metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc" +#filesystem_charset "UTF-8" # -# Enable this if you wish to use your MPD created playlists in -# other music players. +# This setting controls the encoding that ID3v1 tags should be converted from. # -#save_absolute_paths_in_playlists "no" +#id3v1_encoding "ISO-8859-1" # -################################################################ +############################################################################### |