Files
shairport-sync/ADVANCED/CONFIGURATION_OPTIONS.md
T

77 lines
3.3 KiB
Markdown

Under Construction
=====
Configuration Flags
===
Configuration flags determine the features of Shairport Sync that are included. The idea is to have a compact core set of features, so that Shairport Sync can be installed in low-capacity devices. Extra features that take up extra space can be added using configuration flags.
Back Ends
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-alsa` | Choose ALSA API support (GNU/Linux only) |
| `--with-pa` | Choose PulseAudio support. |
| `--with-sndio` | Choose SNDIO API support |
| `--with-jack` | Include a Jack Audio Connection Kit (jack) backend |
| `--with-stdout` | Include the stdout audio back end |
| `--with-pipe` | Include the pipe audio back end |
| `--with-dummy` | Include the dummy audio back end |
| `--with-ao` | Choose AO (Audio Output?) API support. |
| `--with-soundio` | Choose soundio API support. |
Operating System Support
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-os=OSType` | Specify the distribution to target: One of `linux`, `freebsd` or `darwin`. |
Installation Support
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-systemv` | Install a System V startup script during a make install |
| `--with-systemd` | Install a systemd startup script during a make install |
| `--with-freebsd-service` | Install a FreeBSD startup script during a make install |
| `--with-cygwin-service` | Install a CYGWIN config script during a make install |
| `--with-configfiles` | Install configuration files during a make install |
Zeroconf/Bonjour Support
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-external-mdns` | Support the use of `avahi-publish-service` or `mDNSPublish` to advertise the serviceon Bonjour/ZeroConf |
| `--with-avahi` | Choose Avahi-based mDNS support |
| `--with-tinysvcmdns` | Choose tinysvcmdns-based mDNS support |
| `--with-dns_sd` | Choose `dns_sd` mDNS support |
Interprocess Communication
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-dbus-interface` | Include support for the native Shairport Sync D-Bus interface |
| `--with-dbus-test-client` | Compile dbus test client |
| `--with-mpris-interface` | Include support for a D-Bus interface conforming to the MPRIS standard |
| `--with-mpris-test-client` | Compile an MPRIS test client |
| `--with-mqtt-client` | Include a client for the Message Queuing Telemetry Transport (MQTT) protocol |
Audio Features
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-apple-alac` | Include support for the Apple ALAC decoder |
| `--with-soxr` | Choose `libsoxr` for high-quality interpolation |
| `--with-convolution` | Choose audio DSP convolution support |
General
---
| Configuration Flag | Brief Explanation |
| --- | --- |
| `--with-pkg-config` | Use pkg-config to find libraries |
| `--with-libdaemon` | Include support for daemonising in older non-systemd systems |
| `--with-piddir=<pathname>` | Specify a pathname to a directory in which to write the PID file.
| `--with-ssl=<library>` | Choose `--with-ssl=openssl`, `--with-ssl=mbedtls` or `--with-ssl=polarssl` (deprecated) for encryption services. |
| `--with-metadata` | Include support for a metadata feed |
| `--with-systemdsystemunitdir=DIR` | Specify the directory for `systemd` service files |