Table of Contents
Felix Obenhuber <email@example.com>
is a software Jukebox designed for touchscreen usage. It's for playing mp3/vorbis and m3u files (inclusive radio streams). The main goal has been the album or radio station selection via album art images in an old fashioned way.
Currently JukX is in a quick and dirty hack - just good enough to serv my kitchen with music ;-). It's NOT a simple install and run app atm - see music collection for the background. JukX is released under the terms of the GNU General Public License v2.
Feel invited to improve/comment - but don't forget to post the patch!
JukX has been developed on and for an x86 Debian 4.1 Etch system. Due there are no OS dependent parts within the script it should run on every target you're able to install
For non-Unix like platform (e.g Microsoft Windows), some changes on source level are required.
As above, the concept of JukX aims to control the application via a touchscreen interface. Mouse/Trackball/Touchpad usage of course also might work but is quite "uncool".
First of all you'll need a working installation of XMMS2 (release Jerkyll or higher). JukX is written in Python, so without Python installed on the target system you won't have much fun. Furthermore JukX makes use of the Python bindings of GTK2. The GUI is created using Glade 2. You can check your Python installation by manually importing the modules referenced in the main JukX Python script.
For installation instructions, please refer the INSTALL document, shipped with your JukX release.
JukX is configured by a small an simple config file, that can be placed here:
The keys are IMHO quite self speaking…
[jukx] # specify path to jukx pixmaps # default: /usr/share/jukx/pixmaps pixmap_path=/usr/share/jukx/pixmaps # set cmd to be executed whe shutdown button pressed # default: true shutdown_cmd='sudo /sbin/shutdown -h now' # set 1 to insert [A-Z] buttons - direct jump # default: 1 show_jump_buttons=1 # try to save cpu usage by stopping playback when a new album is selected # default: 0 save_CPU=1 # main window resolution # default: 800x600 xres=800 yres=600 # directory to store and search cached files # default: ~/.config/xmms2/clients/jukx/cache #art_cache_dir=/tmp [layout] # chooser geometry # default: 5x3 chooser_cols=7 chooser_rows=5 # size of albums thumbs # default: album_thumb_siz=160 # size of wallpaper cover # default: 400 album_siz=550 # fullscreen mode # default: 1 fullscreen=1 # show statusbar # default: 0 show_statusbar=1 # show albums without a coverfile specified by binhash value # default: 0 show_nocover=1
JukX expects you to have a very clean music collection. To listen to some mp3 or vorbis files you'll need them to be integrated into your XMMS2 media database AND linked to some album art image files. Without a cover file specified for a specific media file you won't be able to select it withing JukX. Please refer the XMMS2 documentation for details.
For full resolution shots - please check the SF project site screenshot section
JukX is in a very alpha state… here's the todo list:
If you want to tell the JukX developers something about - don't hang fire to post on the projects mailing list:
JukX was initially launched by Felix and proceeded to the current state with the help of many people: