]> git.ipfire.org Git - thirdparty/shairport-sync.git/commitdiff
Update CONFIGURATION_OPTIONS.md
authorMike Brady <mikebrady@eircom.net>
Fri, 22 Mar 2019 18:47:51 +0000 (18:47 +0000)
committerGitHub <noreply@github.com>
Fri, 22 Mar 2019 18:47:51 +0000 (18:47 +0000)
ADVANCED/CONFIGURATION_OPTIONS.md

index 8b137891791fe96927ad78e64b0aad7bded08bdc..c4d7865bfa11adcce6c42ced528a6173fe88edd8 100644 (file)
@@ -1 +1,73 @@
+Under Construction
+=====
+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 |