LIBSOXR.md

   1
   2 The Raspbian image at the time of writing is the `May 2016` version, with the release date of `2016-05-10`. It does not include `libsoxr`, but it is available as a package via `apt-get`.
   3
   4 Alternatively, `libsoxr` is very easy to compile. Here are very brief instructions to download, compile and install it:
   5
   6 * Install `cmake`. This is used in the building of libsoxr. On Linuxes such as Debian/Ubuntu/Raspbian:
   7 ```
   8 # apt-get install cmake
   9 ```
  10 On FreeBSD:
  11 ```
  12 # pkg install cmake
  13 ```
  14
  15 * Download the `libsoxr source`:
  16 ```
  17 $ git clone git://git.code.sf.net/p/soxr/code libsoxr
  18 ```
  19 * `cd` into the `libsoxr` directory and start the build process:
  20 ```
  21 $ cd libsoxr
  22 $ ./go
  23 ```
  24 Be patient! This takes a long time on a Raspberry Pi -- it looks like it gets stuck around 40% or 50%, but it will finish if you let it.
  25
  26 Having compiled `libsoxr`, it must now must be installed:
  27 ```
  28 $ cd Release
  29 # make install
  30 ```
  31 Finally, for Shairport Sync to be able to locate `libsoxr` during compilation, you need to tell `ld` about it.  Be careful here if you are on FreeBSD -- the following instructions for Linux would mess up your FreeBSD system.
  32
  33 On Linuxes such as Debian/Ubuntu/Raspbian:
  34 ```
  35 # ldconfig -v
  36 ```
  37 On FreeBSD you must add the location of the `soxr.pc` file to the `PKG_CONFIG_PATH`, if it exists, and define it otherwise. Here is what you do if it doesn't already exist:
  38 ```
  39 $ PKG_CONFIG_PATH="/usr/local/lib/pkgconfig"
  40 $ export PKG_CONFIG_PATH
  41 ```
  42 That's it. Now you can select the `--with-soxr` option when you're building Shairport Sync.