INSTALL.md

Type make to build the packet decoder, hairtunes.

You need the following installed:

• openssl
• libao
• Perl 5.10 or higher
• Linux: avahi
• Windows/Mac OS X: Bonjour

Perl modules (install from CPAN if needed e.g. perl -MCPAN -e 'install X'):

• HTTP::Request
• HTTP::Message
• Crypt::OpenSSL::RSA
• IO::Socket::INET6

Debian/Ubuntu:

apt-get install libssl-dev libcrypt-openssl-rsa-perl libao2 libao-dev libio-socket-inet6-perl libwww-perl avahi-utils pkg-config
make
perl shairport.pl

Redhat/Fedora:

yum install openssl-devel libao libao-devel perl-Crypt-OpenSSL-RSA perl-IO-Socket-INET6 perl-libwww-perl avahi-tools
make
perl shairport.pl

Mac OS X:

• install XCode

• install Homebrew or MacPorts

• type:

  $ export ARCHFLAGS="-arch x86_64" (replace x86_64 by your arch)
  $ brew install pkg-config libao # for [Homebrew](https://github.com/mxcl/homebrew)
  $ port install pkgconfig libao # for [MacPorts](http://www.macports.org/)
  $ make
  $ perl -MCPAN -e 'install Crypt::OpenSSL::RSA'
  $ perl -MCPAN -e 'install IO::Socket::INET6'
  $ perl shairport.pl
  

Users of OS X 10.5 and below will need to install a newer Perl (via port/brew).

How to run as a daemon on Mac 10.6

$ cp hairtunes shairport.pl /usr/local/bin
$ vi /usr/local/bin/shairport.pl, change the path of hairtunes from ./hairtunes to /usr/local/bin/hairtunes
$ mkdir -p ~/Library/LaunchAgents
$ cp org.mafipulation.shairport.plist ~/Library/LaunchAgents/
$ launchctl load org.mafipulation.shairport.plist
$ launchctl unload org.mafipulation.shairport.plist (to remove)

Windows

• Download and install Cygwin.

• During setup, select

  • openssl-devel
  • openssl
  • libao
  • libao-devel
  • gcc4
  • make
  • pkg-config
  • perl

• Install Bonjour for Windows

• Launch the Cygwin Bash shell

• type:

   $ make
   $ perl -MCPAN -e 'install Crypt::OpenSSL::RSA'
   $ perl -MCPAN -e 'install IO::Socket::INET6'
   $ perl shairport.pl