Jukefox Help

If you do not like to read lengthy manuals, please check out our short tour that is directly integrated in the application (menu->help).

You might also want to have a look at the quick guide that summarizes the key steps required for a successful library import.

Moreover, we have an faq section that lists some of the most frequently asked questions.


jukefox provides all functionality of a traditional music player, and a lot more, for example:
  • A map of your collection that allows you to naturally browse your album covers in two or three dimensions.
  • A smart shuffling mode that plays random songs, but only from regions that match your current mood.
  • Automatically generated tag-clouds that allow for a fine-grained selection of the music you want to play.
  • Scrobbling to last.fm.
  • Shake controls to skip songs or stop your music when the device is in your pocket.
This functionality is arranged in five main screens and a settings dialog:
  • Player Screen: The player screen provides the usual functionality to play songs and manage a playlist. In addition to the traditional play modes, it offers a smart shuffling and a similar music mode that are extremely helpful when working with large music collections.
  • List Screen: From the list screen you can choose one of the following lists to browse for music: artist, album, tracks, genres, tags. The first four lists are based on information in your music files' id3-tags and can be found in any state-of-the-art music player. The last list (tags) offers an automatically generated tag cloud which is tailored at your collection, and allows for a fine-grained selection of music, dependent on your taste and mood.
  • Search Screen: The search screen provides a full-text search interface on title and artist. A nice extension of the search module is that it can suggest music that might match your needs, even if the requested music is not available on your device.
  • 3D Map Screen: The 3d map offers a visual interface to browse your album covers. The covers are arranged such that similar albums are located close to each other.
  • 2D Map Screen: Similar to the 3d map, the 2d map provides a visual interface to navigate your collection. The integrated zoom bar allows for a seamless transition between an overview perspective and a detail view of your collection. Tag-labels ensure that you do never loose the orientation while browsing your music.
  • Settings Dialog: jukefox is highly customizable. Using the settings dialog, you can, for example, choose to scrobble your music to last.fm, manage shake controls, or enable a lockscreen with player buttons.

You can switch between these five screens using the tabs at the top of the application screen. (In landscape mode you find the tabs on the left side of the screen.)

Player Screen


The player screen shows artist and title of the currently played track, a progress bar used to indicate and set the position within the track, the album cover of the currently playing track, or, alternatively, the current playlist, and the most relevant buttons for music control and playlist handling. To see the current playlist instead of the album cover, just click on the cover. If you do not touch the playlist for more than 5 seconds, the album cover will automatically reappear. If you prefer to always see the playlist, you can tell jukefox to not automatically show the album art by deselecting the corresponding entry under 'menu->settings->advanced settings->show big album art'.

Album cover and playlist

To see the current playlist instead of the album cover, just click on the cover. If you do not touch the playlist for more than 5 seconds, the album cover will automatically reappear. If you prefer to always see the playlist, you can tell jukefox to not automatically show the album art by deselecting the corresponding entry under 'menu->settings->advanced settings->show big album art'. To manually switch back to the album art, just wipe your finger horizontally over the playlist.

Playlist control

On the right side of each playlist entry, there is a handle that allows you to drag the corresponding song to another position within the playlist. Moreover, a number of playlist options are available from the playlist menu, which you reach by clicking the playlist button (bottom left). Here you can clear the current playlist (also used to reset the smart shuffling playmode), save the current playlist, or load a previously saved playlist. Moreover, you can select to stop the music after a predefined amount of time (sleep timer).

Context menu

By long-clicking a playlist entry (i.e. by touching it for approximately one second), a context menu appears that offers the following functionality:
  • Remove the song from the playlist.
  • Show the album view (cover, additional songs, tag cloud) corresponding the the song.
  • Move to the corresponding album in the 2d- or 3d-map (the map you visited last will be chosen).
  • Show songs that are similar to the one you clicked.

Play modes

The play modes can be changes using the play mode button (on the bottom right). You can choose between the following options:
  • Repeat: Repeat all songs currently in the playlist.
  • Shuffle: There are two shuffle modes: shuffle over collection, and shuffle over playlist. If you switch to the shuffle playmode, you will be asked to select one of these two playmodes. While shuffle over collection plays all songs of your music library in random order, shuffle over playlist only shuffles over songs that are in your current playlist.
  • Similar Songs: If you are at the end of the playlist, append and play a song that is similar to the last song in the playlist. If the playlist is empty, a random song is chosen. If you are at some other position of the playlist, the currently playing song is used, and any subsequent songs are removed from the playlist. To prevent the playmode to select many songs from the same artist in a row, you are asked to specify a number of songs for which an artist will not be repeated.
  • Smart Shuffling: If you are at the end of the playlist, append and play a song that the smart shuffling algorithm expects to match your mood. Smart shuffling tries to understand your taste and mood as follows: If you skip a song, it assumes that you did not like it. Similarly, if the song reaches the end without being skipped, it is assumed to match your taste. Using this heuristic, jukefox tries to find regions of music that do match your current taste. As a result, the number of skips should be low and you can still listen to a broad range of songs from your collection. The algorithm can be reset by clearing the playlist (see context menu below). If you switch to the smart shuffling playmode while at a position other than the end of the playlist, any subsequent songs will be removed from the playlist.

List Screen


The four lists artists, albums, songs, and genres are self-descriptive and works exactly as you are used to from other music players.

The tags list is rather a tag cloud than a list. It is tailored at you collection, that is, it only shows tags which are descriptive for a certain style of music that is available on your device. You can click (i.e. touch) a tag in order to start playing music that matches this tag. Observe that your active playlist is deleted by this step and the play mode (see Player Screen) is automatically set to play similar music.

Search Screen


The search screen provides a search mode that basically does a standard fulltext search in titles and artists. Moreover you can choose to search in a predefined list of 2000 famous artists that do not necessarily need to be on your device. If a match is found among these artists, jukefox displayes songs that are available in your collection and that are similar to the selected artist.

3D Map


Enjoy flying through your collection in the 3D map. To select a certain album, click on the corresponding cover.

2D Map


The 2D map offers two major functions:

  • Navigation of the map
  • Selection of albums or a set of albums to be played

For navigation, just touch the map in an empty location and move your finger. To zoom in and out, move your finger along the zoom bar on the right side.

To select a single album, touch the corresponding cover. An album view opens. Hit the play button to flush the current playlist and play the entire album. Alternatively, you can first select certain songs only, or you can choose to append the album to the current playlist (second button, right next to play), or to insert the album at the current position in the playlist (third button).

To select a bunch of albums from within an entire region of the map, hit the 'd-pad' (trackball) on your device, and then mark the desired region with your finger (check our video for details).

Settings Dialog


The settings dialog can be opened using menu->settings.

To scrobble your music to last.fm, check the scrobble to last.fm checkbox. You can then enter your last.fm credentials in the appearing input fields. If jukefox is able to connect to last.fm, a warning dialog appears, which informs that scrobbling will open an internet connection every time you finish listening to a song. Be aware that this can incur costs if you do not have an appropriate price plan (the data amounts involved are pretty small, though). For scrobbling, we rely on the ascrblr Java Library.

Further settings you can control using the settings dialog are:

  • Haptic feedback: Switch the vibration feedback of button clicks on or off.
  • Notification: Switch the jukefox notifications on or off.

Quick Guide

  1. Make sure you have inserted an SD-card containing well tagged music files and verify that the SD-card is properly unmounted from your PC (i.e. not mounted for use with a file-explorer on your PC via USB), as otherwise jukefox will not be able to read your music files.
  2. jukefox can look for image files to use as album art. If an image has the file name cover.jpg, cover.png, folder.jpg, folder.png, albumart.jpg, or albumart.png it is used as the album art for the music files in the same directory.
  3. Start jukefox.
  4. At first startup, jukefox shows an import dialog. You can only use jukefox after the import has completed. This step acquires the required song coordinates from the web and - dependant on the size of your collection - might take a while. For the import to be successful, make sure that the id3-tags of your music files contain correct artist, album and track information, and that your device is connected to the Internet. jukefox should automatically detect if your collection changes, and fetch the missing information from the web. If, for some reason, jukefox does not detect library changes, you can manually relaunch the import process under menu->settings. Observe that the import process is the only moment when jukefox requires a working Internet connection.
  5. You are now ready to explore your collection with jukefox. All the functionality provided by the player will work without being connected to the Internet.