From 53138a393b64f6fc66c6698c14f565bd9e208d5e Mon Sep 17 00:00:00 2001 From: Maxim Cournoyer Date: Fri, 28 Apr 2023 00:13:56 -0400 Subject: services: mpd: Update basic example. Relates to . * doc/guix.texi (Audio Services): Do not use a deprecated user form; keep the default one. Remove port. Specify a music-directory. Mention the importance of permissions on the music directory. --- doc/guix.texi | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 31643bfacf..58cc3d7aad 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -34241,16 +34241,27 @@ The Music Player Daemon (MPD) is a service that can play music while being controlled from the local machine or over the network by a variety of clients. -The following example shows how one might run @code{mpd} as user -@code{"bob"} on port @code{6666}. It uses pulseaudio for output. +The following example shows the simplest configuration to locally +expose, via PulseAudio, a music collection kept at @file{/srv/music}, +with @command{mpd} running as the default @samp{mpd} user. This user +will spawn its own PulseAudio daemon, which may compete for the sound +card access with that of your own user. In this configuration, you may +have to stop the playback of your user audio applications to hear MPD's +output and vice-versa. @lisp (service mpd-service-type (mpd-configuration - (user "bob") - (port "6666"))) + (music-directory "/srv/music"))) @end lisp +@quotation Important +The music directory must be readable to the MPD user, by default, +@samp{mpd}. Permission problems will be reported via @samp{Permission +denied} errors in the MPD logs, which appear in @file{/var/log/messages} +by default. +@end quotation + Most MPD clients will trigger a database update upon connecting, but you can also use the @code{update} action do to so: -- cgit 1.4.1