Mike Brady
0965077c0e
Removed redundant information about user services and automatic startup of Shairport Sync. Added a link to the relevant section for starting Shairport Sync as a user service.
2.1 KiB
Working with PulseAudio or PipeWire
Many Linux systems, especially desktop Linuxes with a GUI, have PipeWire or PulseAudio installed as sound servers. PipeWire and PulseAudio are widely used and have the great advantage of being easily able to mix audio from multiple sources.
However, the main thing to remember about PipeWire and PulseAudio sound servers is they only become available when a user logs in -- that is, they are set up as user services. Shairport Sync relies on them and therefore it must also be set up as a user service. Shairport Sync can not be set up as a system service because the PipeWire or PulseAudio services are not available when system services are launched just after system startup.
To use PipeWire or PulseAudio-based systems, Shairport Sync must be set up as a user service.
Considerations
- Shairport Sync will work without modification in a PipeWire- or PulseAudio-based system if built with the default ALSA backend. This is because PipeWire and PulseAudio both provide a default ALSA pseudo-device to receive and play audio from ALSA-compatible programs.
- Shairport Sync can be built with "native" PipeWire or PulseAudio backends by adding the
--with-pipewireor--with-pulseaudioconfiguration flags when it is being built. This has the advantage of bypassing the ALSA compatability layer. - To check if PipeWire support is built into Shairport Sync, check that the string
PipeWireis included in the version string. (Enter$ shairport-sync -Vto get the version string.) Similarly, the version string will includePulseAudioif the PulseAudio backend is built in. - Remember to specify which backend Shairport Sync should use in the configuration file or on the command line.
Starting Shairport Sync as a User Service
Please refer to this section to discover how to start Shairport Sync as a user service.