MPD - Revision history

Novida: fix duplicate code block error

2026-06-07T04:34:55Z

fix duplicate code block error

← Older revision		Revision as of 04:34, 7 June 2026
Line 133:		Line 133:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.~~settings~~ = {		services.mpd.user = "userRunningPipeWire";
	~~audio_output~~ = [		systemd.services.mpd.environment = {
	{		# https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/609
	~~type~~ = "~~pipewire~~";		XDG_RUNTIME_DIR = "/run/user/${toString config.users.users.userRunningPipeWire.uid}"; # User-id must match above user. MPD will look inside this directory for the PipeWire socket.
	~~name = "My~~ PipeWire ~~Output";~~
	}
	];
	};		};
	</syntaxhighlight>		</syntaxhighlight>

Novida: Migrated services.mpd.extraConfig to services.mpd.settings with proper Nix attribute set syntax.

2026-06-07T04:31:49Z

Migrated services.mpd.extraConfig to services.mpd.settings with proper Nix attribute set syntax.

← Older revision		Revision as of 04:31, 7 June 2026
Line 18:		Line 18:
	enable = true;		enable = true;
	musicDirectory = "/path/to/music";		musicDirectory = "/path/to/music";
	~~extraConfig~~ = ''		settings = {
	# must specify one or more ~~outputs~~ in order to play audio!		# must specify one or more audio_output blocks in order to play audio!
	# (e.g. ALSA, PulseAudio, PipeWire), see next sections		# (e.g. ALSA, PulseAudio, PipeWire), see next sections
	'';		};

	# Optional:		# Optional:
Line 40:		Line 40:
	Then, add a PulseAudio output to MPD:		Then, add a PulseAudio output to MPD:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.~~extraConfig~~ = ''		services.mpd.settings = {
	audio_output {		audio_output = [
	type "pulse"		{
	name "My PulseAudio" # this can be whatever you want		type = "pulse";
	}		name = "My PulseAudio"; # this can be whatever you want
	'';		}
			];
			};
	</syntaxhighlight>		</syntaxhighlight>

Line 60:		Line 62:
	And add <code>server "127.0.0.1"</code> to MPD's config to tell it to connect to PulseAudio's local sound server.		And add <code>server "127.0.0.1"</code> to MPD's config to tell it to connect to PulseAudio's local sound server.
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.~~extraConfig~~ = ''		services.mpd.settings = {
	audio_output {		audio_output = [
	type "pulse"		{
	name "Pulseaudio"		type = "pulse";
	server "127.0.0.1" # add this line - MPD must connect to the local sound server		name = "Pulseaudio";
	}		server = "127.0.0.1"; # add this line - MPD must connect to the local sound server
	'';		}
			];
			};
	</syntaxhighlight>		</syntaxhighlight>
	After editing the configuration and running <code># nixos-rebuild switch</code>, you can test if everything is working by using a MPD client, such as <code>MPC</code>.		After editing the configuration and running <code># nixos-rebuild switch</code>, you can test if everything is working by using a MPD client, such as <code>MPC</code>.
Line 74:		Line 78:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	hardware.pulseaudio.systemWide = true;		hardware.pulseaudio.systemWide = true;

	services.mpd.~~extraConfig~~ = ''		services.mpd.settings = {
	~~audio_output~~ {		audio_output = [
	type "pulse"		{
	name "Pulseaudio"		type = "pulse";
	mixer_type "hardware" # optional		name = "Pulseaudio";
	mixer_device "default" # optional		mixer_type = "hardware"; # optional
	mixer_control "PCM" # optional		mixer_device = "default"; # optional
	mixer_index "0" # optional		mixer_control = "PCM"; # optional
	} '';		mixer_index = "0"; # optional
			}
			];
	};		};
	</syntaxhighlight>		</syntaxhighlight>
Line 91:		Line 97:
	You can also use alsa, just add audio output to services.mpd.extraConfig:		You can also use alsa, just add audio output to services.mpd.extraConfig:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.~~extraConfig~~ = ''		services.mpd.settings = {
	audio_output {		audio_output = [
	type "alsa"		{
	name "My ALSA"		type = "alsa";
	device "hw:0,0" # optional		name = "My ALSA";
	format "44100:16:2" # optional		device = "hw:0,0"; # optional
	mixer_type "hardware"		format = "44100:16:2"; # optional
	mixer_device "default"		mixer_type = "hardware";
	mixer_control "PCM"		mixer_device = "default";
	}		mixer_control = "PCM";
	'';		}
			];
			};
	</syntaxhighlight>		</syntaxhighlight>

Line 109:		Line 117:
	To use PipeWire with a system-wide MPD instance, create an <code>audio_output</code> for it:		To use PipeWire with a system-wide MPD instance, create an <code>audio_output</code> for it:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.~~extraConfig~~ = ''		services.mpd.settings = {
	audio_output {		audio_output = [
	type "pipewire"		{
	name "My PipeWire Output"		type = "pipewire";
	}		name = "My PipeWire Output";
	'';		}
			];
			};
	</syntaxhighlight>		</syntaxhighlight>
	See https://mpd.readthedocs.io/en/stable/plugins.html#pipewire for more options.		See https://mpd.readthedocs.io/en/stable/plugins.html#pipewire for more options.
Line 123:		Line 133:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.~~user~~ = ~~"userRunningPipeWire";~~		services.mpd.settings = {
	~~systemd.services.mpd.environment~~ = {		audio_output = [
	~~# https://gitlab.freedesktop.org/~~pipewire~~/pipewire/-/issues/609~~		{
	~~XDG_RUNTIME_DIR~~ = "~~/run/user/${toString config.users.users.userRunningPipeWire.uid~~}"; ~~# User-id must match above user. MPD will look inside this directory for the PipeWire socket.~~		type = "pipewire";
			name = "My PipeWire Output";
			}
			];
	};		};
	</syntaxhighlight>		</syntaxhighlight>

Jasi: /* NixOS installation */ correction: startWhenNeeded is no longer under the network attribute.

2025-10-05T00:27:29Z

NixOS installation: correction: startWhenNeeded is no longer under the network attribute.

← Older revision		Revision as of 00:27, 5 October 2025
Line 3:		Line 3:
	== Home-manager Installation ==		== Home-manager Installation ==
	Home-manager has a module for MPD which runs it as a systemd user service, giving it easier access to your user's sound server. In most cases no specific audio output configuration is necessary:		Home-manager has a module for MPD which runs it as a systemd user service, giving it easier access to your user's sound server. In most cases no specific audio output configuration is necessary:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">services.mpd = {
	services.mpd = {
	enable = true;		enable = true;
	musicDirectory = "/path/to/music";		musicDirectory = "/path/to/music";
Line 10:		Line 9:
	network.listenAddress = "any"; # if you want to allow non-localhost connections		network.listenAddress = "any"; # if you want to allow non-localhost connections
	network.startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket		network.startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket
	};		};</syntaxhighlight>
	</syntaxhighlight>


Line 27:		Line 25:
	# Optional:		# Optional:
	network.listenAddress = "any"; # if you want to allow non-localhost connections		network.listenAddress = "any"; # if you want to allow non-localhost connections
	~~network.~~startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket		startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket
	};		};
	</syntaxhighlight>		</syntaxhighlight>

Tejing at 15:50, 22 June 2025

2025-06-22T15:50:08Z

← Older revision		Revision as of 15:50, 22 June 2025
Line 1:		Line 1:
	[https://www.musicpd.org/ Music Player Daemon] (MPD) is a flexible, powerful, server-side application for playing music. Through plugins and libraries, it can play a variety of sound files while being controlled by its network protocol.		[https://www.musicpd.org/ Music Player Daemon] (MPD) is a flexible, powerful, server-side application for playing music. Through plugins and libraries, it can play a variety of sound files while being controlled by its network protocol.

	== Installation ==		== Home-manager Installation ==
	A typical config, running MPD system-wide, will look like this:		Home-manager has a module for MPD which runs it as a systemd user service, giving it easier access to your user's sound server. In most cases no specific audio output configuration is necessary:
			<syntaxhighlight lang="nix">
			services.mpd = {
			enable = true;
			musicDirectory = "/path/to/music";
			# Optional:
			network.listenAddress = "any"; # if you want to allow non-localhost connections
			network.startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket
			};
			</syntaxhighlight>


			== NixOS Installation ==
			A typical NixOS config, running MPD system-wide, will look like this:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd = {		services.mpd = {
Line 20:		Line 33:

	== PulseAudio ==		== PulseAudio ==
	In order to use MPD with PulseAudio, enable sound support in the NixOS <code>configuration.nix</code> :		In order to use system-wide MPD with PulseAudio, enable sound support in the NixOS <code>configuration.nix</code> :
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	# Enable sound.		# Enable sound.
Line 96:		Line 109:
	Make sure PipeWire is enabled. See [[PipeWire]]		Make sure PipeWire is enabled. See [[PipeWire]]

	To use PipeWire, create an <code>audio_output</code> for it:		To use PipeWire with a system-wide MPD instance, create an <code>audio_output</code> for it:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.mpd.extraConfig = ''		services.mpd.extraConfig = ''
Line 109:		Line 122:

	=== PipeWire workaround ===		=== PipeWire workaround ===
	PipeWire typically runs as a normal user, while MPD will run under a system user. A workaround is to configure MPD to run under the same user as PipeWire:		PipeWire typically runs as a normal user, while a system-wide MPD instance will run under a system user. A workaround is to configure MPD to run under the same user as PipeWire:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">

Treeways: Add description for MPD

2025-06-02T18:28:57Z

Add description for MPD

← Older revision		Revision as of 18:28, 2 June 2025
Line 1:		Line 1:
			[https://www.musicpd.org/ Music Player Daemon] (MPD) is a flexible, powerful, server-side application for playing music. Through plugins and libraries, it can play a variety of sound files while being controlled by its network protocol.

	== Installation ==		== Installation ==
	A typical config, running MPD system-wide, will look like this:		A typical config, running MPD system-wide, will look like this:

Mic92: /* Installation */ fix startWhenNeeded option

2024-07-13T07:49:33Z

Installation: fix startWhenNeeded option

← Older revision		Revision as of 07:49, 13 July 2024
Line 12:		Line 12:
	# Optional:		# Optional:
	network.listenAddress = "any"; # if you want to allow non-localhost connections		network.listenAddress = "any"; # if you want to allow non-localhost connections
	startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket		network.startWhenNeeded = true; # systemd feature: only start MPD service upon connection to its socket
	};		};
	</syntaxhighlight>		</syntaxhighlight>

Mic92: fix links

2024-04-01T13:54:19Z

fix links

← Older revision		Revision as of 13:54, 1 April 2024
Line 92:		Line 92:

	== PipeWire ==		== PipeWire ==
	Make sure PipeWire is enabled. See ~~https://nixos.wiki/wiki/~~PipeWire		Make sure PipeWire is enabled. See [[PipeWire]]

	To use PipeWire, create an <code>audio_output</code> for it:		To use PipeWire, create an <code>audio_output</code> for it:

imported>Makefu: use uid of pipewire user instead of guessing the number

2024-02-19T18:46:49Z

use uid of pipewire user instead of guessing the number

← Older revision		Revision as of 18:46, 19 February 2024
Line 113:		Line 113:
	systemd.services.mpd.environment = {		systemd.services.mpd.environment = {
	# https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/609		# https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/609
	XDG_RUNTIME_DIR = "/run/user/~~1000~~"; # User-id ~~1000~~ must match above user. MPD will look inside this directory for the PipeWire socket.		XDG_RUNTIME_DIR = "/run/user/${toString config.users.users.userRunningPipeWire.uid}"; # User-id must match above user. MPD will look inside this directory for the PipeWire socket.
	};		};
	</syntaxhighlight>		</syntaxhighlight>

imported>Joeriexelmans: Restructure article + add section on PipeWire

2022-02-15T14:37:32Z

Restructure article + add section on PipeWire

Show changes

imported>Nix: add Software/Applications subcategory and Audio category

2021-09-20T06:05:50Z

add Software/Applications subcategory and Audio category

← Older revision		Revision as of 06:05, 20 September 2021
Line 125:		Line 125:
	}		}
	</syntaxhighlight>		</syntaxhighlight>

			[[Category:Audio]]
			[[Category:Applications]]