summaryrefslogtreecommitdiffstats
path: root/audio-players/mpd/init.d/mpd.conf
diff options
context:
space:
mode:
Diffstat (limited to 'audio-players/mpd/init.d/mpd.conf')
-rw-r--r--audio-players/mpd/init.d/mpd.conf424
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"
#
-################################################################
+###############################################################################