Other Settings

The State File

The state file is a file where MPD saves and restores its state (play queue, playback position etc.) to keep it persistent across restarts and reboots. It is an optional setting.

MPD will attempt to load the state file during startup, and will save it when shutting down the daemon. Additionally, the state file is refreshed every two minutes (after each state change).

SettingDescription
state_file PATH Specify the state file location. The parent directory must be writable by the MPD user (+wx).
state_file_interval SECONDS Auto-save the state file this number of seconds after each state change. Defaults to 120 (2 minutes).

Resource Limitations

These settings are various limitations to prevent MPD from using too many resources (denial of service).

SettingDescription
connection_timeout SECONDS If a client does not send any new data in this time period, the connection is closed. Clients waiting in "idle" mode are excluded from this. Default is 60.
max_connections NUMBER This specifies the maximum number of clients that can be connected to MPD at the same time. Default is 5.
max_playlist_length NUMBER The maximum number of songs that can be in the playlist. Default is 16384.
max_command_list_size KBYTES The maximum size a command list. Default is 2048 (2 MiB).
max_output_buffer_size KBYTES The maximum size of the output buffer to a client (maximum response size). Default is 8192 (8 MiB).

Buffer Settings

Do not change these unless you know what you are doing.

SettingDescription
audio_buffer_size KBYTES Adjust the size of the internal audio buffer. Default is 4096 (4 MiB).
buffer_before_play PERCENT Control 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. Default is 10%.