From: Mike Brady <mikebrady@eircom.net>
Date: Fri, 9 Feb 2018 20:51:17 +0000 (+0000)
Subject: Create OPENBSD.md
X-Git-Tag: 3.2RC1~19
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a6d0f647f7a26b469ff26af70924d95d491d3fce;p=thirdparty%2Fshairport-sync.git

Create OPENBSD.md
---

diff --git a/OPENBSD.md b/OPENBSD.md
new file mode 100644
index 00000000..6b0428f5
--- /dev/null
+++ b/OPENBSD.md
@@ -0,0 +1,48 @@
+Shairport Sync on OpenBSD using `sndio`
+----
+This is an initial note about installing Shairport Sync on OpenBSD. Shairport Sync compiles and maybe runs (?) natively on OpenBSD using the `sndio` back end.
+
+General
+----
+This build was done on a default build of `OpenBSD 6.2 GENERIC.MP#134 amd64`.
+
+First, update everything.
+```
+TBA
+```
+Install the Avahi subsystem. 
+```
+TBA
+```
+Enable the D-Bus and Avahi subsystems
+```
+TBA
+```
+Building
+----
+
+Install the packages that are needed for Shairport Sync to be downloaded and built successfully.
+```
+TBA
+```
+Now, download Shairport Sync from GitHub:
+```
+$ git clone https://github.com/mikebrady/shairport-sync.git
+$ cd shairport-sync
+```
+Next, switch to the `development` branch, configure the build and compile it:
+
+```
+$ git checkout development
+$ autoreconf -i -f
+$ ./configure  --with-avahi --with-ssl=openssl --with-sndio --with-os=openbsd
+$ make
+```
+
+There is no make install yet -- you're on your own.
+
+Using the `sndio` backend
+----
+
+The `sndio` back end does not have a hardware volume control facility.
+You should set the volume to maximum before use, using, for example, the `mixerctl` command.