Tutorial - Video Directory Structure

Roksbox can show your videos based on your video directory structure. With this option, you don't need to create a videos.xml file. But if you want to show details, you can create a small xml file for each video that defines the details for that video.

When using the directory structure option, Roksbox will start at the root folder of your video structure, and scan each subfolder for videos. The first level of folders below your root folder will be used as the main categorys, and each subfolder that contains one of more videos will be used as a subcategory. The names of the folders will be used as the category names. If there are videos in the root folder, they will show up under a main category called Video Root.

A simple directory structure scan will not show any details such as actors, description, length, rating, or poster art on the Roksbox screen. However, you can add these features with some additional work.

To include poster art, put a jpg poster file with the same name as the folder or video in the folder which contains the folder or video. For example, if you have a folder called The Office under a folder called TV, place a file called The Office.jpg in the TV folder. Also, if you have a video called episode 1 in the folder called The Office, place a file called episode 1.jpg in the The Office folder. Do the same for each of your other folders and videos. You don't need to include poster art for the top level folders, because Roksbox doesn't use poser art for main categories. Also, if you don't include poster art for the subfolders, Roksbox will use the poster art from the first video in the folder.

If you want to include details such as actors, description, length, rating, etc., you can create a small xml file for each video which will go in the same folder as the video. The xml file must have the same name as the video, with a .xml extension. For example, for a video called eposide 1.mp4, you would have an xml file called episode 1.xml in the same folder as the episode 1.mp4 file. Following is the xml file format to use for the detail information:


title - A title which will be used instead of the video name. If no title is specified, the video name will be used for the title.
year - The year the video was created or released.
genre - The genre for this video.
mpaa - The Motion Picture Association of America rating, such as PG, PG-13, etc.
director - The director for this video.
actors - Up to three actors, seperated by commas.
description - A detailed description of the video.
length - The length of the video in minutes. If the video is less that 15 minutes long, you can also include seconds with the format :SS. For example, if the video is 12 minutes and 35 seconds, you could use 12:35.

Valid Rating Values

To use your directory structure to show your videos, delete the Video XML Name on the Roksbox Network Settings screen, or do not include a videos.xml file in your video root folder. Also, directory listings must be enabled on your web server.

You also must have your web server and setup information working as described in this tutorial, and your videos must be accessible from your web server.

The recommended poster art size is:

Movie Poster Art (portrait): SD=158x204; HD=214x306


For an alternative to manually creating XML files see the following option:

Using Movie Sheets - Create Movie Sheets, and detail information for videos (Windows only).



Remember to use "Quick Click" to quickly navigate along the top row when using the Poster screen. Click your left or right mouse button "quickly" (about two clicks per second) to navigate without having to wait for the poster art to be retrieved and displayed on each click.

Back | Next