PhJuke - Music Jukebox for Photon

Home Page

Downloads

Documentation
   User Interface
   Hotkeys
   Directory Browsing
   PHJ Files
   Remote Control
   The FAQ

Screenshots

Change Log

Audrey!

Frequently Asked Questions

User Interface
Can I browse using custom button images?
Why doesn't the song position slider work?
Miscellaneous
How do I download and install this thing?
Accented characters in filenames don't work.
My playlists contain absolute paths. Can I use them?
I use Ogg Vorbis instead of MP3. Can I use PhJuke?
I can't save playlists when I launch PhJuke from the browser.
What's with that "unknown symbol: log" message?
Why so few images on this Web site?

User Interface

Can I browse using custom button images?

Absolutely! This is discussed in the Directory Browsing and PHJ Files section of the documentation.

Why doesn't the song position slider work?

The playback engines PhJuke uses doen't support jumping around to different places in a track. I plan to add support for one that does, at which point you'll be able to drag the slider.

Miscellaneous

How do I download and install this thing?

See the instructions on the Downloads page.

Accented characters in filenames don't work.

By default, PhJuke is configured to play files from a Windows fileserver. If you're using a different OS (or your files are local on your QNX system) you'll need to edit the $HOME/.phjuke file (on an Audrey this is usually just /.phjuke) and change the fs-charset setting so it has the same value as the data-charset setting. In most cases you'll want a value of ISO-8859-1.

It may be possible to autodetect the filesystem character set somehow, but it wasn't immediately obvious to me; if you know a way, drop me a line.

My playlists contain absolute paths. Can I use them?

If your playlist manager writes absolute paths to its M3U files, such as D:\foo\bar\song.mp3, you can use PhJuke's directory mapping feature to compensate. With PhJuke not running, add one line to your preferences file ($HOME/.phjuke) for each remote-mounted directory. For example, if you have D:\Foo\Bar mounted on the Audrey as /music, you'd add:
map-dir d:/foo/bar/=/music/
Note that PhJuke uses forward slashes, not backslashes, even on Windows paths, and that the mapping is case-insensitive.

I use Ogg Vorbis instead of MP3. Can I use PhJuke?

Yes! The binary distribution includes an Ogg Vorbis decoder.

I can't save playlists when I launch PhJuke from the browser.

This is because programs launched from the browser are run using restricted access permissions. There are two workarounds.
  1. Make sure you save your playlists to a directory that's world-writable, such that the restricted user has the ability to write files there. To make a local Audrey directory world-writable:

    chmod 777 directory_name

    You may have to do something different if you want to save lists to a directory on a fileserver.

  2. Make PhJuke setuid root. Assuming you have it installed in /nto/bin and you were using a root shell when you installed it:

    chmod 4711 /nto/bin/phjuke

    Since it would ordinarily run as root (if launched via a root pterm or from the options panel) this isn't too huge a security hole; it's not like the Audrey is really a robust multiuser environment.

What's with that "unknown symbol: log" message?

I'm not sure. It seems to be a slight incompatibility between the Photon libraries on the Audrey and the ones from the full QNX 6.0 distribution. I've tried a couple things to get rid of it, but no luck so far. The message appears to be completely harmless, so just try to ignore it. If you know how to get rid of it, please drop me a line.

Why so few images on this Web site?

This site is served from my home Linux box, and my bandwidth is very limited, so I'd rather keep things small, simple, and fast-loading. That, and I'm horrible at graphic design.

Steven Grimm