Wiki

Clone wiki

Theme Manager Ex (Theme Engine) / How to override a template.xml

Theme Manager Ex has an home-made template.xml parser.

It is simple and it probably needs a big optimization, but it is capable of parsing simple templates and most of, if not all, the system templates.

However, support is partial for complex templates and it does not support all the tags.

You should avoid template override for:

  • Ps1 live area: Untested, probably not working because it seems dynamic!
  • Store live area: Working, BUT its frames are dynamic, your changes will be lost!
  • Browser live area: Working, BUT its frames are dynamic, your changes will be lost!


The template override is 100% reversible and it will not damage/delete/overwrite any file in your system.

How to override a template

  1. Enable the override in your themeEx.xml (see Themes Structure)
  2. Place your template.xml in TITLE-ID folder (example NPXS10008/template.xml)




How to add custom images to your template

You MUST use this when your template defines a new image that does not exist in the original one.

Example:
The Photos App defines 3 images in its template.xml.

If you want to physically replace them, you CANNOT use this method. (See here)
If you want to remove them, a simple template override will do the job, SKIP this step!
If you want to add a 4th image to the Photos App, you NEED this!

Instructions:

Create a folder named custom in TITLE-ID/contents.
Add the images to your template.xml using the following path: custom/ImageName.png

example: NPXS10000/contents/custom/IMAGES HERE



The only supported tag is <frame>, any other tag like <gate> or <livearea-background> will be skipped.

You can only add ONE custom bg and ONE custom img per frame.

See THMX Preview theme for an example structure

Updated