PhJuke - Music Jukebox for Photon

Home Page

Downloads

Documentation

Screenshots

Change Log

Audrey!

Version

The latest version of PhJuke is 1.1. It requires the madplay and ogg123 commands, which do the actual audio playback for MP3 and Ogg Vorbis files, respectively. Audrey binaries are available here.

Downloads

If you're not sure whether you want the binary or source versions of these programs, use the binary versions. Download the "All Programs" bundle unless you're certain you only need one or two of the three programs. To download, right-click on a Download link and choose the "Save As" or "Save Target As" option. I recommend saving the file to a directory that's mounted over the network on the Audrey.

NOTE: If you're currently using version 1.0.1 or earlier, you will need to download a fresh copy of madplay!

Program Binary Source
All Programs Compressed (midwinter.com)
Non-Compressed (midwinter.com)
n/a
PhJuke 1.1 Download (midwinter.com) Download (midwinter.com)
MAD 0.14.2b Download (midwinter.com) Distribution - Audrey Patch
OGG Vorbis 1.0RC2 Download (midwinter.com) Distribution - Audrey Patches

Installation

First, some prerequisites. You won't be able to use PhJuke on your Audrey unless you have all of these things set up already. Detailed instructions for most of these items can be found in Chris Russo's Audrey Hack FAQ (worth a look if you're new to Audrey hacking) or on AudreyHacking.com -- please ask on the message board there if you have questions, since I'm not able to provide support for Audrey issues that aren't directly related to my software.

  • A USB Ethernet adapter connected to your local area network. PhJuke doesn't support streaming MP3s over the modem (it'd sound awful anyway.)
  • Shell access
  • A remote-mounted filesystem from a Windows or UNIX server (or maybe a Mac, but I don't know about that.) You can use fs-nfs2 or fs-cifs; PhJuke will provide smooth playback either way. Technically you could play MP3s from Audrey's local filesystem but there isn't much room there.
  • If you want to download the compressed version of the install bundle, you will need the "zcat" command from the QNX 6.0 distribution. Otherwise you should download the larger, non-compressed version.

With all that out of the way, assuming you've downloaded the bundle of both programs, here's what you need to do to install them. These instructions assume that you've saved the file to whichever directory you're remote-mounting on the Audrey (easier than setting up FTP on the Audrey).

  1. Open a shell on your Audrey
  2. Type cd /nto/bin
  3. If you downloaded the compressed version of the bundle, type zcat /xxx/phjuke-bundle.tar.gz | tar xvf - where /xxx is the path to your remote-mounted directory, the one where you saved the file. If you downloaded the non-compressed version, instead type tar xvf /xxx/phjuke-bundle.tar

PhJuke and madplay are now installed. You'll probably want to look over the documentation briefly, but if you're anxious to get started, cd to a remote-mounted directory with some MP3s, type phjuke, and you should be in business.

Steven Grimm