Using RobinHood with BIYS


So you want to dump that light-weight internal web server, and replace it with something a little more heavy-duty; like RobinHood, eh? Good choice! You'll find that RobinHood will serve up files faster and more reliably than the internal web server could ever dream of.

So where do we start? Well, you might already be using RobinHood 1.2 (in which case, you'll want to not install RobinHood, and edit your virtual_hosts file to contain everything the bundled one does -- just add all the uncommented text from the bundled virtual_hosts file to your existing one, below everything that's already there), or you may not have RobinHood installed at all. In either case, it's pretty simple to get BIYS to groove with it. The following steps, completed and followed verbatim, will do just that:

Step 1 - installation:

- Make sure that you've run the Be In Your Stereo installer first.
- Install RobinHood by double-clicking on RobinHood1.2.pkg (included in this distribution in the RobinHood directory).
- Drag the file virtual_hosts (included in this distribution in the RobinHood directory) to the folder labeled ``drop `virtual_hosts' here" (and choose `Replace' when prompted).

Step 2 - configuration:

So now that you've got everything installed, it's time for configuration:

- Configure BIYS (from its Plugin configuration panel in SoundPlay) so that it doesn't use the internal web server.
- Add the following line to your UserBootscript:

/boot/apps/RobinHood/server/rhdaemon &

- Skin selection should still be done via BIYS' Plugin configuration panel in SoundPlay.
- I highly recommend reading RobinHood's docs.
- That's it! If you don't have rhdaemon running right now, just double-click on it. Point your browser to http://127.0.0.1:8080 and you should be golden.


next: PHP API for skin authors or skip to the closing notes if you don't want to write your own skin.