Media Jukebox

This is a classic media server implementation, which you can share with any other device in the house. What's so special about this one?

The location of the media is largely irrelevant. Movies can be stored on any computer or laptop in the house, per categories. You can download some at work on your laptop and when you come home just pop open the lid and they're "in the cloud".

The files are organised in folders. There's entry points, i.e. O:\Media followed by categories. The entry points are configured per device and the basic assumption is that they are shared - you have to configure also the share name (that's how the remote agents can access the files).

When you search for a category, the entire cloud is searched and the results meshed together. You don't generally care where the media is.

To move media around, simply move the respective files around. There is NO INDEX to worry about.

  • MyDesktop
    • O:\Media - shared as OMedia
      • Comedy
        • one_comedy.avi
      • Documentaries
        • Nature Dokus
          • NatureDocumentaries.series.txt
          • doku1.divx
          • doku2.avi


Categories are configured in the media.xml file. The first level of folders under the entry points must be a category name.


There's some simple support for series, where a series of movies belong together, like episodes. Simply create an empty XXX.series.txt file in the directory holding the episodes. You can as usual create an XXX.series.JPG file which will be used to represent the series.

When you're opening a series, the episodes you've seen already are at the bottom. They're moved there when you click "play". If you change your mind, there's buttons to move them back up. The state of the series is kept in the XXX.series.txt file, which you can wipe clean.

You can move the series folders around without problems.


TODO - more details

We currently use the VLC player to play most video content. The associations are configurable in the media.xml file, in the asset finders section.

Make sure the VLC player is installed properly on your system, in the right path, see media.xml. Currently C:\Program Files\VideoLAN\VLC\vlc.exe on windows and /usr/bin/vlc on linux (ubuntu).

Media management functionality

There's very simple media management functionality. You can find an icon for a movie on, say, Google and save it locally - it will always be used for that movie.

You can move movies between categories (i.e. move from "TODO" to "Comedy"). You can remove media (it goes to the "bin" folder).

Other than that, just move stuff around as much as you'd like - there's no indexes or other stuff you need to worry about.

Finders and supported formats

The supported formats, how to find them and what to use to play them - that's all configured in media.xml


The jukebox is avialable over UPNP as well - try it from your Playstation. This function is not very advanced because since we don't transcode formats on the fly, it didn't seem that interesting to me…

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License