My Movies Wiki

HDI Dune Template Customization

Modified: 2010/10/22 16:49 by admin - Uncategorized

Version Notice!

This guide is based on the functionality in My Movies for Windows Media Center and My Movies Collection Management 3.18 or later, or My Movies for Windows Home Server 1.61 or later. If you are running an earlier version, please upgrade before proceeding with this guide.



My Movies Collection Management and My Movies for Windows Home Server can be used to store an advanced meta-data index for the HDI Dune media players. The meta-data index generation is based on a user customizable XML based template, which advanced users can edit and change to their personal preference. This page will go throug how template customization works. Be aware that simple template customization can be done by most users, but advanced changes also requires advanced and technical users.


Understanding Dune

The meta-data index for the Dune is created by storing a set of instruction files and graphics files that the Dune reads and displays. Before you start customizing the template, it is recommended that you read how this instuction file method works - the instruction files for the Dune is called "dune_folder.txt", and the specification on how it works can be found here:

My Movies will store a set of these files, which differs based on their location in the index.


Template File Locations

The template files for the Dune is stored in the "C:\ProgramData\My Movies\FileStorage\User Customization\Meta Data\Dune Templates" folder on Windows 7 and Windows Vista, and in the "C:\Documents and Settings\All Users\Application Data\My Movies\FileStorage\User Customization\Meta Data\Dune Templates" on Windows XP. Users of My Movies for Windows Home Server can access the template on the share "\\servername\MyMoviesFileStorage$\User Customization\Meta Data\Dune Templates". It is recommended to use the My Movies Collection Management program during template customization, as it offers a better overview when making changes than the Windows Home Server console.

The default template My Movies uses is stored in the file "My Movies Default.xml" with a corresponding "My Movies" compressed file. The compressed files is automatically uncompressed onto a "My Movies Default" directory the first time a template is used. To create a new and custom template, you should start by copying the "My Movies Default.xml" to a custom name such as "My Template.xml", and similar copy the "My Movies Default" folder to a folder with the name "My Template" - if the "My Movies Default" folder does not exist, you can create it by extracing the "My Movies" file. Compressing the "My Template" folder back to a Zip file is not needed.

The "My Template.xml" file will now be the file to edit for changing the template content, while the "My Template" folder will where you can change or add graphics files and font files. In the created "My Template" folder is a "Parts" folder containing graphical pieces that is not needed directly by the template, but can be used to create custom icons and similar based on the My Movies Default Template.

Important! You must start by editing the copied "My Template.xml" file and changing the name of the template in the "Name" node (first node) in the XML document.


Part 1: Index Categories

The index My Movies creates contains a set of categories such as "All titles", "Alfabetic", "Genres" and similar. The template holds options of creating additional categories that is not included in the "My Movies Default" template, which means you can choose to have more categories or fewer categories than in the "My Movies Default" template. Go to the "IncludedCategories" in the XML file, and set the node value to "True" to include a category, and to "False" to exclude a category. The different categories will be explained below:

"AllTitles" - Contains a complete list of all the titles in your collection.

"Alfabetic" - Contains an alfabetic index with #, A, B, C, ect. folders containing titles starting with the selected letter.

"Genres" - Contains a list of genres with titles in them. One title can be part of multiple genres.

"LastAdded" - Contains a list of the 50 titles that have been added last to your collection.

"Categories" - Contains a list of personal categories as created within the Collection Management program, with the assigned titles within each category.

"Decades" - Contains a list of decades with titles in them.

"Years" - Contains a list of years with titles in them.

"ParentalRating" - Contains a list of parental ratings with titles in them. The parental rating names is based on the current localization.

"RunningTime" - Contains a list of running times with 10 minute jumps, with titles in them.

"Trailers" - Contains a trailer section with different sub-entries.

"GenresAndCategories" - Containes a combined list of genres and categories.

"TopActors" - Contains a list of actors with titles they star in below them. Unless you create a positive list of specific actors to include, it is recommended that you set the "TitleRequirement" to a value of 3 or higher to not include all actors - this value specifies how many titles the actor must star in to be included in the index.

If you enable the "TopActors" category, be aware that you can either let the program decide which actors to include based on the "TitleRequirement" setting, or you can uncomment the "TopActors" section in the XML file, and create a list of specific actors to include in the index. If you create a specific list of actors, be sure to set the "TitleRequirement" setting back to 1 to include all the actors in your list.


Part 2: Basic Graphics Customization

The graphics used in the index is all stored in the created "My Template" folder. Be aware that it is not recommended to change the pixel size of the files unless you at the same time edit the template layout where the graphics piece is used. In the folder, there are different sub folders, which we will go through below.


The "Genres" folder contains alpha transparent icons for all the genres in My Movies. Notice that the list of genres in My Movies is fixed and does not change - users with requests for personal genres should use the categories option for this.

Each image exists with their "GenreName.png" and as a selected image with the name "Selected-GenreName.png" - the naming of these files should not be changed. The "My Movies Default" template is created to not show selection boxes as per the options in the "dune_folder.txt" files, but if you change this, the "Selected-GenreName.png" can be left out.

If you would like to change the genre icons, but keep them in the same looks as the My Movies default icons, you can get the blank background images from the "Parts" folder within the root "My Template" folder.


The "Categories" folder is by default empty, but can be used to create custom icons for the "Categories" or the "GenresAndCategories" index section, if you have personal categories created in your movie collection with the Collection Management program.

Similar to genres, you should place a PNG with the name of the category such as "My Category.png", and a selected image to go with it, with the name "Selected-My Category.png". If you use personal categories but do not place images for the categories in the template, the "General" image from the "Index" folder is used as a replacement.


The "Index" folder contains the entry images for the index categories, and the "My Movies" logo icon used as the entry image into the meta-data index.

The "General.png" (and "Selected-General.png") is used as a placeholder image for categories without custom images, and for sub categories in the "Alfabetic", "Parental Rating" and similar index category that uses generic folder graphics.

The "FilmTrailer.png" (and "Selected-FilmTrailer.png") icon is used for the sub folders in the "Trailers" index category section.

The "My Movies.png" (and "Selected-MyMovies.png") icon is used as the entry name into the index.

If you change the pixel size of the images it is recommended to also adjust the box location and sizes in the "dune_folder.txt" specifications.


Besides the graphics in the icon folders, you can also customize other graphical parts of the template. Graphics that relates to the movie details page will not be covered by this section, but will be covered seperately in the movie details page customization section. Graphics that relates to the covers in cover overviews will also not be covered in this section, but will be covered seperately in the covers customization section.

The graphic pieces listed in this section is all referenced by filename in the XML file of the template - if you however do not change the names in the XML template you can change these files directly and leave them with their current names.

The "CategoryBackground.jpg" graphics is used as the default background when browsing the index.

The "InsertDisc.jpg" graphics is used as a background that indicates to the user to inserted an offline disc requested for playback. The name of the disc is for storage usage reasons not printed onto the image, and the image is therefore created to be a generic image for any disc inserts.


Part 3: Cover Customization

To come.


Part 4: Movie Details Page Customization

To come.


Part 5: Section and Layout Customization

To come.