,

1 files changed, 7 insertions, 3 deletions

diff --git a/nixos/modules/features/mpd/default.nix b/nixos/modules/features/mpd/default.nix
index 383180d..a339622 100644
--- a/nixos/modules/features/mpd/default.nix
+++ b/nixos/modules/features/mpd/default.nix
@@ -1,7 +1,9 @@
 { pkgs, ... }:
 
 {
-  # MPD server
+  # MPD server (music player daemon). The audio_output points at PipeWire
+  # through its PulseAudio compatibility layer, since desktop audio is handled
+  # by modules/system/audio.
   services.mpd = {
     enable = true;
     user = "seraphim";
@@ -21,12 +23,14 @@
     };
   };
 
+  # MPD runs as a system service, so it needs the per-user runtime dir to
+  # reach the PipeWire socket.
   systemd.services.mpd.environment = {
     XDG_RUNTIME_DIR = "/run/user/1000";
   };
 
-  # mpd-mpris is the MPRIS bridge for MPD — only useful when MPD is on,
-  # so it lives in the same feature. Disable by removing this block.
+  # mpd-mpris bridges MPD to the MPRIS media control interface (used by
+  # Waybar/media keys). Lives here because it only matters when MPD is on.
   systemd.user.services.mpd-mpris = {
     description = "MPD MPRIS Service for Waybar";
     wantedBy = [ "default.target" ];