Tim Douglas
ebe637f0ca
Howl hasn't been actively developed for some years now; their website 404s, and the Wayback Machine archive of 2008 says it's dead.[1] Yet it's still functional and is much smaller than dbus and avahi, which makes it useful for embedded systems. In fact, OpenWrt has not dropped support for the howl tools, and it's because of howl that I can fit a functional shairport and supporting libraries and kernel onto the 4MB of flash in a TP-LINK TL-WR703N.[2] [1] http://web.archive.org/web/20080917182117/http://www.porchdogsoft.com/products/howl/ [2] http://embeddedtimes.blogspot.com/2011/09/tp-link-tl-wr703n-tiny-linux-capable.html
97 lines
3.0 KiB
Markdown
97 lines
3.0 KiB
Markdown
Type `make` to build the packet decoder, `hairtunes`.
|
|
|
|
You need the following installed:
|
|
|
|
* openssl
|
|
* libao
|
|
* Perl 5.10 or higher
|
|
* Linux: avahi (or, for embedded systems, howl)
|
|
* 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 build-essential libssl-dev libcrypt-openssl-rsa-perl 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
|
|
|
|
## Gentoo/Funtoo
|
|
|
|
echo "media-libs/libao alsa" >> /etc/portage/package.use
|
|
echo "net-dns/avahi mdnsresponder-compat" >> /etc/portage/package.use
|
|
echo "dev-perl/HTTP-Message ~x86" >> /etc/portage/package.keywords
|
|
echo "dev-perl/HTTP-Date ~x86" >> /etc/portage/package.keywords
|
|
echo "dev-perl/Encode-Locale ~x86" >> /etc/portage/package.keywords
|
|
echo "dev-perl/LWP-MediaTypes ~x86" >> /etc/portage/package.keywords
|
|
emerge libao avahi dev-perl/HTTP-Message dev-perl/Crypt-OpenSSL-RSA dev-perl/IO-Socket-INET6
|
|
rc-update add dbus default
|
|
rc-update add avahi-daemon default
|
|
/etc/init.d/dbus start
|
|
/etc/init.d/avahi-daemon start
|
|
make
|
|
perl shairport.pl
|
|
|
|
## OpenBSD
|
|
|
|
pkg_add -r gmake libao avahi p5-libwww p5-Crypt-OpenSSL-RSA p5-IO-Socket-INET6
|
|
gmake
|
|
perl shairport.pl
|
|
|
|
## Mac OS X:
|
|
|
|
* install XCode
|
|
* install [Homebrew](https://github.com/mxcl/homebrew) or [MacPorts](http://www.macports.org/)
|
|
* 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' # (may require sudo)
|
|
$ perl -MCPAN -e 'install IO::Socket::INET6' # (may require sudo)
|
|
$ 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](http://support.apple.com/kb/DL999)
|
|
* Launch the Cygwin Bash shell
|
|
* type:
|
|
|
|
$ make
|
|
$ perl -MCPAN -e 'install Crypt::OpenSSL::RSA'
|
|
$ perl -MCPAN -e 'install IO::Socket::INET6'
|
|
$ perl shairport.pl
|