INSTALL
*******

'Install' probably isn't the right word here: this is a very early release.

But for the bored and the brave here are some clues for getting up and running.

Things will probably go more smoothly if you're on a *nix system.

You will need:
- make
- erlang
  I used R12B-2 obtained from macports with 'sudo port install erlang +smp' - ymmv
- yaws
  Also available from macports with 'sudo port install yaws' - I used v1.76
- a multicast dns utility
  If you're on MacOSX you can use 'mdns'	

Then:

0. Point to Yaws

In the Makefile edit the line

...
YAWS_HOME=/opt/local/lib/yaws/
...

to point to Yaws. If you installed via macports this will be '/opt/local/lib/yaws'.

1. Compile the .beams

MC-S001723:~/Documents/code/bbc2daap woodm05$ make
erl -make
Recompile: src/web_helper
Recompile: src/util
Recompile: src/rtmp_client
...
cp src/*.app ebin/

2. Make an erlang boot file

MC-S001723:~/Documents/code/bbc2daap woodm05$ make boot 
erl -pa ./ebin  -eval 'systools:make_script("bbc2daap_0.1.0", [local, {outdir, "."}, {path,["ebin","priv"]}]), init:stop().' -noshell

If you're not using erlang 12B-2 or Yaws 1.76 the boot build may fail :-(
Review priv/bbc2daap_0.1.0.rel, take a deep breath and dive into 
http://www.erlang.org/doc/design_principles/release_structure.html

3. Advertise your daap share via Multicast DNS

On MacOSX you can use the 'mdns' utility to do this:

MC-S001723:~/Documents/code/bbc2daap woodm05$ mdns -R "BBC Radio" _daap._tcp local 36890 &

The name "BBC Radio" is arbitrary here - change it if you wish.

36890 is the port the proxy will listen on out of the box - to change this you'll 
need to edit the following line in src/bbc2daap.app:

...
  {env,[{listen_port, 36890}]},
...

3. Boot and Go!

MC-S001723:~/Documents/code/bbc2daap woodm05$ make run
erl -pa ./ebin  -smp auto \
-boot bbc2daap_0.1.0
Erlang (BEAM) emulator version 5.6.2 [source] [smp:2] [async-threads:0] [kernel-poll:false]


=INFO REPORT==== 6-Sep-2008::10:26:28 ===
DEBUG id_server:80 {prepare,create,id_uri}

=INFO REPORT==== 6-Sep-2008::10:26:28 ===
DEBUG id_server:80 {prepare,create,sequence}
....

You may see messages like this on the console:
...
=INFO REPORT==== 6-Sep-2008::10:27:52 ===
DEBUG iplayer:48 {iplayer,version_for_episode,no_version_found,episode,
                          "b00d7ksr"}

=INFO REPORT==== 6-Sep-2008::10:27:52 ===
DEBUG util:55 {safe_map,child,exit,no_version_found}
...

These can be 'safely ignored.'

The app can take a few minutes to warm up - you should see the following 
message when it's ready to go:

...
=INFO REPORT==== 6-Sep-2008::10:28:04 ===
DEBUG bbcprogrammes_server:80 {bbcprogrammes,updating}
...

4. Enjoy!

Your radio station should now show up as a shared library in iTunes running on any computer on your local network.