2019-06-13 20:12:29 +02:00
|
|
|
# An example configuration file for MPD.
|
|
|
|
# Read the user manual for documentation: http://www.musicpd.org/doc/user/
|
|
|
|
|
|
|
|
|
|
|
|
# Files and directories #######################################################
|
|
|
|
#
|
|
|
|
# This setting controls the top directory which MPD will search to discover the
|
2021-02-19 03:32:50 +01:00
|
|
|
# available audio files and add them to the daemon's online database. This
|
2019-06-13 20:12:29 +02:00
|
|
|
# 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 "~/Musique"
|
|
|
|
#
|
|
|
|
# This setting sets the MPD internal playlist directory. The purpose of this
|
2021-02-19 03:32:50 +01:00
|
|
|
# directory is storage for playlists created by MPD. The server will use
|
2019-06-13 20:12:29 +02:00
|
|
|
# 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
|
2021-02-19 03:32:50 +01:00
|
|
|
# load the database at server start up and store the database while the
|
2019-06-13 20:12:29 +02:00
|
|
|
# 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.
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
#db_file "~/.mpd/database"
|
|
|
|
#
|
2019-06-13 20:12:29 +02:00
|
|
|
# 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.
|
|
|
|
#
|
2020-01-09 21:17:01 +01:00
|
|
|
log_file "syslog"
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
|
|
|
# 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
|
2021-02-19 03:32:50 +01:00
|
|
|
# it was brought down. This setting is disabled by default and the server
|
2019-06-13 20:12:29 +02:00
|
|
|
# state will be reset on server start up.
|
|
|
|
#
|
|
|
|
state_file "~/.mpd/state"
|
|
|
|
#
|
|
|
|
# The location of the sticker database. This is a database which
|
|
|
|
# manages dynamic information attached to songs.
|
|
|
|
#
|
|
|
|
sticker_file "~/.mpd/sticker.sql"
|
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
|
|
# General music daemon options ################################################
|
|
|
|
#
|
|
|
|
# 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.
|
|
|
|
#
|
|
|
|
#user "nobody"
|
|
|
|
#
|
|
|
|
# This setting specifies the group that MPD will run as. If not specified
|
|
|
|
# primary group of user specified with "user" setting will be used (if set).
|
|
|
|
# This is useful if MPD needs to be a member of group such as "audio" to
|
|
|
|
# have permission to use sound card.
|
|
|
|
#
|
|
|
|
#group "nogroup"
|
|
|
|
#
|
|
|
|
# This setting sets the address for the daemon to listen on. Careful attention
|
2021-02-19 03:32:50 +01:00
|
|
|
# should be paid if this is assigned to anything other than the default, any.
|
2019-06-13 20:12:29 +02:00
|
|
|
# This setting can deny access to control of the daemon. Not effective if
|
|
|
|
# systemd socket activiation is in use.
|
|
|
|
#
|
|
|
|
# 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"
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# Suppress all messages below the given threshold. Use "verbose" for
|
|
|
|
# troubleshooting. Available setting arguments are "notice", "info", "verbose",
|
|
|
|
# "warning" and "error".
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
#log_level "notice"
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
|
|
|
# Setting "restore_paused" to "yes" puts MPD into pause mode instead
|
|
|
|
# of starting playback after startup.
|
|
|
|
#
|
2020-09-15 02:45:25 +02:00
|
|
|
restore_paused "yes"
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
|
|
|
# This setting enables MPD to create playlists in a format usable by other
|
|
|
|
# music players.
|
|
|
|
#
|
|
|
|
save_absolute_paths_in_playlists "yes"
|
|
|
|
#
|
|
|
|
# This setting defines a list of tag types that will be extracted during the
|
|
|
|
# audio file discovery process. The complete list of possible values can be
|
|
|
|
# found in the user manual.
|
|
|
|
metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
|
|
|
|
#
|
|
|
|
# This example just enables the "comment" tag without disabling all
|
|
|
|
# the other supported tags:
|
|
|
|
#metadata_to_use "+comment"
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# This setting enables automatic update of MPD's database when files in
|
2019-06-13 20:12:29 +02:00
|
|
|
# music_directory are changed.
|
|
|
|
#
|
|
|
|
auto_update "yes"
|
|
|
|
#
|
|
|
|
# Limit the depth of the directories being watched, 0 means only watch
|
|
|
|
# the music directory itself. There is no limit by default.
|
|
|
|
#
|
|
|
|
#auto_update_depth "3"
|
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
|
|
# Symbolic link behavior ######################################################
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# If this setting is set to "yes", MPD will discover audio files by following
|
2019-06-13 20:12:29 +02:00
|
|
|
# symbolic links outside of the configured music_directory.
|
|
|
|
#
|
|
|
|
#follow_outside_symlinks "yes"
|
|
|
|
#
|
|
|
|
# If this setting is set to "yes", MPD will discover audio files by following
|
|
|
|
# symbolic links inside of the configured music_directory.
|
|
|
|
#
|
|
|
|
#follow_inside_symlinks "yes"
|
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
|
|
# Zeroconf / Avahi Service Discovery ##########################################
|
|
|
|
#
|
|
|
|
# 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. %h will be replaced with the hostname.
|
|
|
|
#
|
|
|
|
#zeroconf_name "Music Player @ %h"
|
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
|
|
# Permissions #################################################################
|
|
|
|
#
|
|
|
|
# If this setting is set, MPD will require password authorization. The password
|
|
|
|
# setting can be specified multiple times for different password profiles.
|
|
|
|
#
|
|
|
|
#password "password@read,add,control,admin"
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# This setting specifies the permissions a user has who has not yet logged in.
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
|
|
|
#default_permissions "read,add,control,admin"
|
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
|
|
# Database #######################################################################
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# An example of a database section instead of the old 'db_file' setting.
|
|
|
|
# It enables mounting other storages into the music directory.
|
|
|
|
#
|
|
|
|
database {
|
|
|
|
plugin "simple"
|
|
|
|
path "~/.mpd/db"
|
|
|
|
cache_directory "~/.mpd/cache"
|
|
|
|
}
|
|
|
|
#
|
|
|
|
# An example of database config for a sattelite setup
|
|
|
|
#
|
|
|
|
#music_directory "nfs://fileserver.local/srv/mp3"
|
2019-06-13 20:12:29 +02:00
|
|
|
#database {
|
|
|
|
# plugin "proxy"
|
|
|
|
# host "other.mpd.host"
|
|
|
|
# port "6600"
|
|
|
|
#}
|
|
|
|
|
|
|
|
# Input #######################################################################
|
|
|
|
#
|
|
|
|
input {
|
|
|
|
plugin "curl"
|
|
|
|
# proxy "proxy.isp.com:8080"
|
|
|
|
# proxy_user "user"
|
|
|
|
# proxy_password "password"
|
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
# Audio Output ################################################################
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# MPD supports various audio output types, as well as playing through multiple
|
|
|
|
# audio outputs at the same time, through multiple audio_output settings
|
2019-06-13 20:12:29 +02:00
|
|
|
# blocks. Setting this block is optional, though the server will only attempt
|
|
|
|
# autodetection for one sound card.
|
|
|
|
#
|
|
|
|
# An example of an ALSA output:
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "alsa"
|
|
|
|
# name "My ALSA Device"
|
|
|
|
## device "hw:0,0" # optional
|
|
|
|
## mixer_type "hardware" # 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
|
|
|
|
## mixer_type "hardware" # optional
|
|
|
|
## mixer_device "/dev/mixer" # optional
|
|
|
|
## mixer_control "PCM" # optional
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
# An example of a shout output (for streaming to Icecast):
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "shout"
|
|
|
|
# encoder "vorbis" # 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
|
|
|
|
## url "http://example.com" # optional
|
|
|
|
## genre "jazz" # optional
|
|
|
|
## public "no" # optional
|
|
|
|
## timeout "2" # optional
|
|
|
|
## mixer_type "software" # optional
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
# An example of a recorder output:
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "recorder"
|
|
|
|
# name "My recorder"
|
|
|
|
# encoder "vorbis" # optional, vorbis or lame
|
|
|
|
# path "/var/lib/mpd/recorder/mpd.ogg"
|
|
|
|
## quality "5.0" # do not define if bitrate is defined
|
|
|
|
# bitrate "128" # do not define if quality is defined
|
|
|
|
# format "44100:16:1"
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
# 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"
|
|
|
|
# bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
|
|
|
|
## quality "5.0" # do not define if bitrate is defined
|
|
|
|
# bitrate "128" # do not define if quality is defined
|
|
|
|
# format "44100:16:1"
|
|
|
|
# max_clients "0" # optional 0=no limit
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
# An example of a pulseaudio output (streaming to a remote pulseaudio server)
|
2021-02-19 03:32:50 +01:00
|
|
|
#
|
2024-11-21 19:44:35 +01:00
|
|
|
#audio_output {
|
|
|
|
# type "pulse"
|
|
|
|
# name "PipeWire Pulse"
|
2019-06-13 20:12:29 +02:00
|
|
|
# server "remote_server" # optional
|
|
|
|
# sink "remote_server_sink" # optional
|
2021-02-19 03:32:50 +01:00
|
|
|
# media_role "media_role" #optional
|
2024-11-21 19:44:35 +01:00
|
|
|
#}
|
2021-02-19 03:32:50 +01:00
|
|
|
#
|
2019-06-13 20:12:29 +02:00
|
|
|
# An example of a winmm output (Windows multimedia API).
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "winmm"
|
|
|
|
# name "My WinMM output"
|
|
|
|
## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
|
|
|
|
# or
|
|
|
|
## device "0" # optional
|
|
|
|
## mixer_type "hardware" # optional
|
|
|
|
#}
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# An example of a wasapi output (Windows multimedia API).
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "wasapi"
|
|
|
|
# name "My WASAPI output"
|
|
|
|
## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
|
|
|
|
# or
|
|
|
|
## device "0" # optional
|
|
|
|
## Exclusive mode blocks all other audio source, and get best audio quality without resampling.
|
|
|
|
## exclusive "no" # optional
|
|
|
|
## Enumerate all devices in log.
|
|
|
|
## enumerate "no" # optional
|
|
|
|
#}
|
|
|
|
#
|
2019-06-13 20:12:29 +02:00
|
|
|
# An example of an openal output.
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "openal"
|
|
|
|
# name "My OpenAL output"
|
|
|
|
## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
# An example of an sndio output.
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "sndio"
|
|
|
|
# name "sndio output"
|
|
|
|
# mixer_type "hardware"
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
# An example of an OS X output:
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "osx"
|
|
|
|
# name "My OS X Device"
|
|
|
|
## device "Built-in Output" # optional
|
|
|
|
## channel_map "-1,-1,0,1" # optional
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
## Example "pipe" output:
|
|
|
|
#
|
|
|
|
#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"
|
|
|
|
#}
|
|
|
|
#
|
|
|
|
## An example of a null output (for no audio output):
|
|
|
|
#
|
|
|
|
#audio_output {
|
|
|
|
# type "null"
|
|
|
|
# name "My Null Output"
|
|
|
|
# mixer_type "none" # optional
|
|
|
|
#}
|
|
|
|
#
|
2022-05-18 23:22:55 +02:00
|
|
|
|
|
|
|
# ncmpcpp visualization
|
|
|
|
audio_output {
|
|
|
|
type "fifo"
|
|
|
|
name "ncmpcpp_fifo"
|
|
|
|
path "/run/user/1000/mpd.fifo"
|
|
|
|
format "44100:16:2"
|
|
|
|
}
|
|
|
|
|
2024-11-21 19:44:35 +01:00
|
|
|
# pipewire
|
|
|
|
audio_output {
|
|
|
|
type "pipewire"
|
|
|
|
name "PipeWire"
|
|
|
|
}
|
|
|
|
|
2019-06-13 20:12:29 +02:00
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
|
|
# Normalization automatic volume adjustments ##################################
|
|
|
|
#
|
|
|
|
# This setting specifies the type of ReplayGain to use. This setting can have
|
|
|
|
# the argument "off", "album", "track" or "auto". "auto" is a special mode that
|
|
|
|
# chooses between "track" and "album" depending on the current state of
|
|
|
|
# random playback. If random playback is enabled then "track" mode is used.
|
2021-02-19 03:32:50 +01:00
|
|
|
# See <https://wiki.hydrogenaud.io/index.php?title=Replaygain> for
|
|
|
|
# more details about ReplayGain.
|
2019-06-13 20:12:29 +02:00
|
|
|
# This setting is off by default.
|
2021-02-19 03:32:50 +01:00
|
|
|
#
|
2019-06-13 20:12:29 +02:00
|
|
|
replaygain "auto"
|
2021-02-19 03:32:50 +01:00
|
|
|
#
|
2019-06-13 20:12:29 +02:00
|
|
|
# This setting sets the pre-amp used for files that have ReplayGain tags. By
|
|
|
|
# default this setting is disabled.
|
|
|
|
#
|
|
|
|
#replaygain_preamp "0"
|
|
|
|
#
|
|
|
|
# This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
|
|
|
|
# By default this setting is disabled.
|
|
|
|
#
|
|
|
|
#replaygain_missing_preamp "0"
|
|
|
|
#
|
|
|
|
# This setting enables or disables ReplayGain limiting.
|
|
|
|
# MPD calculates actual amplification based on the ReplayGain tags
|
|
|
|
# and replaygain_preamp / replaygain_missing_preamp setting.
|
|
|
|
# If replaygain_limit is enabled MPD will never amplify audio signal
|
|
|
|
# above its original level. If replaygain_limit is disabled such amplification
|
|
|
|
# might occur. By default this setting is enabled.
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
replaygain_limit "yes"
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
|
|
|
# This setting enables on-the-fly normalization volume adjustment. This will
|
2021-02-19 03:32:50 +01:00
|
|
|
# result in the volume of all playing audio to be adjusted so the output has
|
2019-06-13 20:12:29 +02:00
|
|
|
# equal "loudness". This setting is disabled by default.
|
|
|
|
#
|
2022-08-24 21:36:28 +02:00
|
|
|
volume_normalization "no"
|
2019-06-13 20:12:29 +02:00
|
|
|
#
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
# Character Encoding ##########################################################
|
|
|
|
#
|
2021-02-19 03:32:50 +01:00
|
|
|
# If file or directory names do not display correctly for your locale then you
|
2019-06-13 20:12:29 +02:00
|
|
|
# may need to modify this setting.
|
|
|
|
#
|
|
|
|
#filesystem_charset "UTF-8"
|
|
|
|
#
|
|
|
|
###############################################################################
|