Skip to content

Latest commit

 

History

History
27 lines (18 loc) · 1.52 KB

README.md

File metadata and controls

27 lines (18 loc) · 1.52 KB

Shairport Sync

Shairport Sync is an Apple AirPlay audio player. For more information, please visit its GitHub repository.

Basic Usage

$ docker run -d --restart unless-stopped --net host --device /dev/snd \
    mikebrady/shairport-sync

The above command will run Shairport Sync as a daemon in a Docker container, accessing the computer's ALSA audio infrastructure. It will send audio to the default output device and make no use of any hardware mixers the default device might have. The AirPlay service name will be the host's hostname with the first letter capitalised, e.g. Ubuntu.

Options

Any options you add to the command above will be passed to Shairport Sync -- please go to the GitHub repository for more details of the options. Here is an example:

$ docker run -d --restart unless-stopped --net host --device /dev/snd \
    mikebrady/shairport-sync -a DenSystem -- -d hw:0 -c PCM

This will sent audio to alsa hardware device hw:0 and make use of the that device's mixer control called PCM. The service will be visible as DenSystem on the network.

Configuration File

Edit the configuration file /etc/shairport-sync.conf in the container (or use the -v option to mirror an external copy of shairport-sync.conf in to /etc/shairport-sync.conf) to get access to the full range of configuration options.

Lots more information at the GitHub repository.