~~NOTOC~~

== the MUSIC BLACKHOLE

The Music Blackhole is a music collection that so massive that it has collapsed under its own weight. Run wormhole.app to tune in & join the fun.



=== wormhole.app

TODO -- email jamie @ this domain name to beta test

* connects you to blackhole, exposing it as an iTunes music share (for ease of listening) and as a network drive (to download)
* slowly sends your files to the blackhole for strictly personal backup purposes. 


=== shell scripts (DIY)

Requirements:
# ssh
# an mDNS (aka Bonjour or zeroconf) broadcaster, e.g. Avahi (recommended) -- can also use howl or Apple's mDNSResponderProxyPosix
** Linux (Ubuntu): install avahi and avahi-utils, e.g. //apt-get install avahi avahi-utils//
** Mac OS X: nothing required (!) -- use the dns-sd line instead of avahi
** Windows: lots required; TODO 


**wormhole.sh**
<code bash>
#!/usr/bin/env bash
#
# wormhole.sh
# by Jamie Wilkinson <jamie@tramchase.com>
#
# simple frontend for connecting to a remote daap share and sharing it with your LAN
# more: Music Blackhole <http://tramchase.com/projects/music-blackhole>

# config
SERVER=colossus.eyebeam.org
USER=blackhole
SHARE="-g" #  set to blank to keep the connection to yourself, set to "-g" to share with your LAN

# config you probably do not need to change
LOCALPORT=3690
REMOTEPORT=3689
LOGFILE="$0.log" # change to /dev/null to disable logging

# work
echo "Establishing ssh tunnel..."
ssh -v -N -f $SHARE $USER@$SERVER -L 3690:$SERVER:3689 > $LOGFILE 2&>1

echo "Broadcasting mDNS service..."
# avahi-publish-service -v blackhole-`hostname` _daap._tcp. 3690 > $LOGFILE 2&>1 &
dns-sd -P "blackhole-jdubtop" _daap._tcp. local 3690 localhost localhost > $LOGFILE 2&>1 &
# mDNSProxyResponderPosix 127.0.0.1 blackhole "BLACKHOLE Music Server" _daap._tcp 3690 > $LOGFILE 2&>1 &

echo "done." 
echo "Kill the associated ssh & avahi-publish-servive processes to turn it off; this is a TODO item."
exit
</code>