PlayStation 3 Theme (P3T)

Classic theme

Original theme

Description

P3T (Playstation 3 Theme) is a container. Themes can be created by Sony's official PlayStation 3 theme creator software or by theme compilers from third-party developers. PlayStation 3 themes are able to store images and sounds to customize the XMB. There is a basic introduction to themes in the official: Theme Settings manual

• Installation methods
  • Downloaded from PSN (SEN) store
  • Downloaded from web pages using the PS3 web browser (hosted in the server as: application/x-ps3-theme MIMEtype, and p3t file extension). E.g: [1] [2]
  • USB, CF, SD, MS, external storage from path: device:/PS3/THEME/Theme Name.p3t
  • Game discs extras icons (see: Creating Discs)
  • Games main menu (the installation of the theme can be unlocked after completing some requirements inside the game)
  • Install packages (.pkg containing an encrypted theme under .edat file)
  • Adding themes manually in the default install path: dev_hdd0/theme/Theme Name.p3t
  • Replacing the preinstalled theme that comes with the firmware in path: dev_flash/vsh/resource/theme/01.p3t

• There is an small chance of crashing XMB when applying a malformed theme (and consecutive PS3 crashes when rebooting), can be easily fixed by entering "recovery menu" and using the option "Restore Default Settings" (only restores the user configurations made in "XMB settings column")
• Other type of crashes happens when the theme is dynamic (contains a .raf scene in the backgound). The .raf scene uses a script that runs in real time when the animation is played and usually contains aritmetic operations to calculate positions along time, etc... any problem derivated from code errors of the script or calculations out of order can make the ram to be overloaded (there is a limited amount available for .raf animations). When this happens the .raf scene crashes (but usually the console doesnt crashes is only the animation played at the background what crashed)

Firmware changes related with XMB and Themes

• Firmware 1.90:
  • Added XMB ⇨ [Theme settings] ⇨ [Background] ⇨ [Wallpaper]. Background setting can use an image from internall HDD. (this image is copied to user profile folder in path: dev_hdd0/home/<userid>/theme/wallpaper.png)

• Firmware 2.00:
  • Added XMB ⇨ [Theme settings] ⇨ [Theme]. Static Themes support. Allows to use custom themes that change the icons, wallpaper, color, font, and the click sounds See Qt Resource Container (QRC) page
  • Added XMB ⇨ [Theme settings] ⇨ [Color]. (original = changes with the month, 1-12 = the colors predefined for each month)
  • Added XMB ⇨ [Theme settings] ⇨ [Background] ⇨ [Brighness] (normal, -1, -2, -3, -4. -5)
  • Added XMB ⇨ [Theme settings] ⇨ [Font] (original, rounded, pop). See XMB Fonts page

• Firmware 3.00:
  • Added Dynamic Themes support. Allows the user to install animated themes. These themes may feature animated backgrounds which change throughout the day or respond to user input. See Rich Appearance Format (RAF) page
  • Added Dynamic brightness. XMB now change color depending on the time of day.
  • The old theme has been renamed to 'Classic'. The default theme has been changed to an updated version of the 'Original' waves theme with an animated sparkle effect
  • Night time black theme has the current month color as a basis instead of white. ?

P3T structure

See: CXML Containers page

Theme Tools

Tools to compile, extract, or manage themes

P3Tcompiler

P3Tcompiler is made by sony. For a basic guide creating themes with p3tcompiler read the official manual: How do I create my own theme for the PlayStation®3 computer entertainment system?

• Download links
  • P3Tcompiler v2.00 included in: PS3 Custom Theme Toolbox

With the program there is a sample theme ready to compile, you can separate the program folder and the sample folder to any path in your pc, and compile the sample theme just by "drag-and-drop" the simple.xml over ps3compiler.exe (or create a "direct access icon" in the desktop to the program and drag-and-drop .xml files over it). The compiled theme .pt3 is created in the same folder of the source .xml + lot of .gim files (this .gim files are generated in the conversion from .png--->.gim as a previous step before compiling, after compilation the .gim files are not erased)

Or use the command line:

Usage : p3tcompiler.exe [-o] [output file(*.p3t)] [input file(*.xml)]
C:\PS3 Theme Compiler>p3tcompiler.exe -o "C:\PS3 Compiled Themes\Theme Name.p3t" "C:\PS3 Themes Files\Theme Name.xml"

P3Textractor

Made by codelogic in ps2dev forum, is from 2007 and advised in an alpha stage, can be downloaded from: p3textractor

This program extract the contents of a Theme.p3t and it works too by the "drag-and-drop" method, but the files are extracted to the same folder of the program, in a subfolder named like the original Theme.pt3 preceded by a "extracted"

Or use the command line:

Usage: p3textractor <input theme file> [destination path]
C:\PS3 Theme Extractor>p3textractor.exe "C:\PS3 Compiled Themes\Theme Name.p3t" "C:\PS3 Themes Files\Theme Name\"

Playstation 3 Theme Builder

http://www.lili-chan.com/

Xross Media Simulator

http://www.lili-chan.com/

Theme Contents

Theme Name (.XML)

This is the settings file of the theme, needed by the compiler to build the theme, it contains information about the theme and the author, and lists all the files that composes the theme.

Code Sample

Other XML configurations

• <localizedinfo>

Is posible to add translations for different languages for some contents of <info> by using <localizedinfo> (XMB replaces contents in the <info> by the contents of <localizedinfo>), each language is identifyed with a "letter code" listed in this table: Languages

Localized info texts are only displayed when the laguage setting used in XMB matches with the language used in the "locale" of the theme

If the theme doesnt contains <localizedinfo> the default texts from <info> are used , so <localizedinfo> is not mandatory, and usually is not needed (most of the <info> contents doesnt need to be translated)

Code Sample

PlayStation Languages

Code		Name		Support
2-digits	2-letters	Localised	English	PS1	PS2	PSP	PS3	PSV	PS4	PS5
00	ja	日本語	Japanese	ALL ?	ALL	1.00	1.00	1.00	1.00	1.00
01	en	English (United States)	English (United States)
02	fr	Français	French	No ?		1.50
03	es	Español (España)	Spanish (Spain)
04	de	Deutsch	German
05	it	Italiano	Italian
06	nl	Nederlands	Dutch
07	pt	Português (Portugal)	Portuguese (Portugal)
08	ru	Русский	Russian		EXT
09	ko	한국어	Korean			2.00	1.50
10	ch	繁體中文	Chinese (Traditional)			2.70	1.60
11	zh	简体中文	Chinese (Simplified)
12	fi	Suomi	Finnish		No	No
13	sv	Svenska	Swedish
14	da	Dansk	Danish
15	no	Norsk	Norwegian
16	pl	Polski	Polish				3.10
17	br	Português (Brasil)	Portuguese (Brazil)				4.00
18	gb	English (United Kingdom)	English (United Kingdom)
19	tr	Türkçe	Turkish				4.30	2.00
20	la	Español (América Latina)	Spanish (Latin America)				No	No
21	ar	العربية	Arabic						2.00
22	ca	Français (Canada)	French (Canada)						2.50
23	cs	Čeština	Czech						5.00
24	hu	Magyar	Hungarian
25	el	Ελληνικά	Greek
26	ro	Română	Romanian
27	th	ไทย	Thai
28	vi	Tiếng Việt	Vietnamese
29	in	Indonesia	Indonesian

• <color selection>

Color allows a value from 0 to 12. With 0 the color changes every month, and from 1 to 12 keeps a permanent color that matches with a month

This color selection affect themes in two different ways, one is a color filter applyed to several parts of the XMB like side menu or default icons (this effect over the icons is only visible when the theme doesnt have icons), and the other are background images in the same color (only visibles when the theme doesnt have a background)

If the theme contains one or several backgrounds, the original backgrounds for months are not displayed, only the "color filter" value is applyed (e.g. in side menu when pressing triangle over an icon)

XMB colors during the year. Color filter values are orientative

Month	All	January	February	March	April	May	June	July	August	September	October	November	December
Color code	0	1	2	3	4	5	6	7	8	9	10	11	12
Day background	Varies
Night background	Varies
Color filter		MonthTime
		CBCBCB	D8BF1A	6DB217	E17E9A	178816	9A61C8	02CDC7	0C76C0	B444C0	E5A708	875B1E	E3412A

Themeicon and Authoricon (.PNG)

icon = theme icon (64x64, 32-bit PNG)

authoricon = author icon(64x64, 32-bit PNG)

Theme Preview (.PNG)

preview = preview icon of the theme (480x270, 24-bit PNG)

XMB Icons (.PNG)

All icons are 128x128, 32-bit PNG, except the ones in the next table

File	NBA	Notes
icon_photo_default	170x128, 32-bit .PNG
icon_photo_album_default		nba
icon_video_default	228x128, 32-bit .PNG
icon_video_album_default

• Default icons

icon_default_h (default icon for horizontal row) and icon_default_v (default icon for vertical columns) are displayed in XMB when the theme doesnt have newest icons required by the firmware. E.g: when installing a theme made in 2008 in a firmware released in 2013

• Missing icons in newer firmwares ?... like PSvita ?

• Missing icons in the example ? (but supported by the compilers)

Notification window (.PNG)

Notification Window Frame - Stretching Layout

Background image that appears at top-right corner of XMB for system messages (used e.g: to notify when a trophy is unlocked)

This image has transparent rounded corners, and is stretched by XMB depending of the lenght of the texts displayed, this stretching is made in the center of the image (not in the corners) to prevent deformation of the rounded corners.

Mouse Pointers (.PNG)

(system_plugin.rco)

Navigation Sounds (.VAG)

(system_plugin.rco)

-Total sound data under 256 KB spreaded between all sound files. (or 150KB as suggested here: http://www.ps3-themes.com/forum/ps3-themes/sound-tutorial-new )

Sound effects as PlayStation Compressed Sound File.

Create the sound files in WAV format @ 44100Hz/16bit-Mono (or lower quality to obtain smaller files). Then use MFaudio v1.1 to convert from WAV to VAG

Fake Stereo Sounds (same sound used in left and right channels

For this method is needed to export the original sound as a single WAV and use the same file in both channels

Code Sample

Stereo Sounds (separated sounds for left and right channels)

For this method is needed to export each channel of the original sound in a separated WAV

Code Sample

Background (.JPG .RAF)

Themes can include up to 24 background images (when trying to include more than 24 backgrounds the compiler returns an: "Error: num of background images are over 24")

Backgrounds sizes

File	File type	File max size	Group max items	Group max size
bg_sd_**.jpg	640x480 JPEG 24bits (4:3 aspect ratio)	2mb	24	??
bg_hd_**.jpg	1920x1080 JPEG 24bits (16:9 aspect ratio)	2mb	24	??
anim_**.raf	?	?	24	??

Static Background (.JPG)

The basic entry for 1 background in two aspect ratios (16:9 and 4:3). Is highly recommended to add both aspect ratios for compatibility with all TV's

Code Sample

The next methods using static backgrounds are variations of this entry, and uses a function (based in system clock time) to select the background that is displayed

The times used in "from" and "until" are included in the period (e.g: from day 01 until day 02.... includes 2 days)

Backgrounds linked to PS3 time (seconds)

This works simply by including multiple backgrounds, the PS3 will select them sequencially starting from the first of the list.

Every time the PS3 boots or every time the theme is applyed, the system time is readed (seconds) the number of backgrounds is counted starting from top of the list and one of them is selected based in the number of seconds in ps3 time. E.g. if the theme contains 24 images and is applyed at time 23:58:00 the first background is displayed, if the theme is applyed at 23:58:23 the last background is displayed, after the last background it loops to the first background of the list e.g: if the theme is applyed at 23:58:24 the first background is displayed

Code Sample

Backgrounds linked to PS3 time (hours of the day)

Note the maximum number of background images supported is 24. You can link them to the 24 hours of the day. Or you can divide the day in 3 periods of 8 hours and use 3 backgrounds for "morning" "evening" and "night"

Code Sample

Backgrounds linked to PS3 time (days of months)

Usefull for special days of special months: a birthday, christmas, etc... The background is visible the same days of all years because the year is not specifyed

Code Sample

Backgrounds linked to PS3 time (days of years)

Useful for special days of special years: the next olympic games, the next apocalypse, etc... it can be used for restrictions too, in the example the image is visible for a period of 1 year (from 31 december 2012, until 31 december 2013)

Code Sample

Dynamic Background (.RAF)

In this themes the background is called an "scene" and is not an image (the scene is compiled in .RAF format by the RAF compiler, but renamed to anim_1.jpg by the theme compiler)

RAF are composed by: 3d geometry models and 3d light models (.dae), textures (.dds), a script (.js), and a scene setting file used by the RAF compiler (.xml)

This is the entry that links to the .RAF background in the main Theme Scene.XML file. Note inside the .RAF there is another RAF Scene.XML that is very different. For more information about this RAf files see: Rich Appearance Format (RAF)

Code Sample

Combined background methods

Collisions

When using combinations of background linked to time (using "days" or "daytime") is important to take care of the "collisions", this happens when 2 different background "wants" to be displayed at the same time (e.g: when using backgrounds linked to time and 2 backgrounds matches with the time). Collisions are not a problem when used on purpose and can give some interesting results (xmb doesnt crashes and the theme keeps working as normal). When a collision happens the first background matching the time is used

In this example the image "safe" is used when the time doesnt match with any of them, the image "win" is used only the day 1 of january of years before 2010 and after 2020, the image "1" is used during the period from 2010 until 2020 included the days 1 of january (in this day "1" and "win" collides and "win" is deprecated because is at the bottom of the list)

Code Sample

The opposite to this collisions is when there is no background that matches the time (but there are backgrounds in the list)... in this case the first background of the list is displayed as a "failsafe" meassure

Static and Dynamic backgrounds linked to PS3 time (seconds)

This combines static (.jpg images), and dynamic (.raf animations) backgrounds, selected based on seconds

Code Sample

See also Discussion page