# PhJuke - Music Jukebox for Photon

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

## 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

Absolutely! This is discussed in the Directory Browsing and PHJ Files section of the documentation.
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

See the instructions on the Downloads page.
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. 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.
Yes! The binary distribution includes an Ogg Vorbis decoder.
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.

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.
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