Editing PlayStation 3 Theme (P3T)

<div style="float:right">[[File:Tex_classic_theme.png|300px|thumb|left|Classic theme]]</div>

<div style="float:right">[[File:Tex_default_theme.png|300px|thumb|left|Original theme]]</div>

P3T ('''P'''laystation '''3''' '''T'''heme) 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: [http://manuals.playstation.net/document/en/ps3/current/settings/themesettings.html Theme Settings manual]

**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: [http://www.ps3-themes.com] [https://web.archive.org/web/*/http://ps3devwiki.com/files/Visuals/Themes]

**Install packages (.pkg containing an encrypted theme under [http://www.psdevwiki.com/ps3/EDAT_files| .edat file])

*Firmware [[1.90_CEX|1.90]]:

**Added [[XMB]] {{icon category settings}} '''⇨ [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_CEX|2.00]]:

**Added [[XMB]] {{icon category settings}} '''⇨ [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]] {{icon category settings}} '''⇨ [Theme settings] ⇨ [Color]'''. (original = changes with the month, 1-12 = the colors predefined for each month)

**Added [[XMB]] {{icon category settings}} '''⇨ [Theme settings] ⇨ [Background] ⇨ [Brighness]''' (normal, -1, -2, -3, -4. -5)

**Added [[XMB]] {{icon category settings}} '''⇨ [Theme settings] ⇨ [Font]''' (original, rounded, pop). See [[XMB Fonts]] page

*Firmware [[3.00_CEX|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

P3Tcompiler is made by Sony. For a basic guide creating themes with p3tcompiler read the official manual: [http://us.playstation.com/support/answer/index.htm?a_id=1205 How do I create my own theme for the PlayStation®3 computer entertainment system?]

**P3Tcompiler v2.00 included in: [https://web.archive.org/web/20160804062919/http://e1.dl.playstation.net/e1/downloads/ps3/themes/370/PS3_Custom_Theme_v200.zip]

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)

Made by [http://lukasz.dk/mirror/forums.ps2dev.org/viewtopic70d2.html?t=9342 codelogic in ps2dev forum], is from 2007 and advised in an alpha stage, can be downloaded from: [http://www.ps3-themes.com/theme-extractor p3textractor]

Or use the command line:

https://web.archive.org/web/20080819044230/http://www.lili-chan.com/downloads.htm

https://web.archive.org/web/20080819044230/http://www.lili-chan.com/downloads.htm

{{Boxcode|title=Theme_name.xml (complete sample)|code=<syntaxhighlight lang="xml">

<!--------------------------------------------------------------------------------------------------------------- Theme Info -->

    <infotable>

        <info

            comment="Theme description"

            name="Theme name"

            author="Your name, nick, team, company, etc..."

            url="http://www.psdevwiki.com"

            authoricon="theme_author_icon_64x64.png"

            version="v0.1 beta"

            genre="PS3 Themes Design"

            preview="theme_preview_480x270.png"

            icon="theme_icon_64x64.png"

        />

    </infotable>

<!--------------------------------------------------------------------------------------------------------------- Icons -->

    <icontable>

        <!------------------------------------------------------------------------------------------------------- XMB Horizontal row -->

        <icon id="icon_user"                   src="icon_user.png"/>

        <icon id="icon_setting"                 src="icon_setting.png"/>

        <icon id="icon_photo"                   src="icon_photo.png"/>

        <icon id="icon_music"                   src="icon_music.png"/>

        <icon id="icon_video"                   src="icon_video.png"/>

        <icon id="icon_game"                   src="icon_game.png"/>

        <icon id="icon_network"                src="icon_network.png"/>

        <!------------------------------------------------------------------------------------------------------- XMB User column -->

        <icon id="icon_poweroff"               src="icon_poweroff.png"/>

        <icon id="icon_newuser"                 src="icon_newuser.png"/>

        <!------------------------------------------------------------------------------------------------------- XMB Settings column -->

        <icon id="icon_update"                 src="icon_update.png"/>

        <icon id="icon_game_setting"           src="icon_game_setting.png"/>

        <icon id="icon_bdvd_setting"           src="icon_bdvd_setting.png"/>

        <icon id="icon_music_setting"           src="icon_music_setting.png"/>

        <icon id="icon_chat_setting"           src="icon_chat_setting.png"/>

        <icon id="icon_system_setting"         src="icon_system_setting.png"/>

        <icon id="icon_theme_setting"           src="icon_theme_setting.png"/>

        <icon id="icon_datetime_setting"       src="icon_datetime_setting.png"/>

        <icon id="icon_powersave_setting"       src="icon_powersave_setting.png"/>

        <icon id="icon_accessory"               src="icon_accessory.png"/>

        <icon id="icon_printer_setting"        src="icon_printer_setting.png"/>

        <icon id="icon_display_setting"        src="icon_display_setting.png"/>

        <icon id="icon_sound_setting"           src="icon_sound_setting.png"/>

        <icon id="icon_security_setting"       src="icon_security_setting.png"/>

        <icon id="icon_remoteplay_setting"     src="icon_remoteplay_setting.png"/>

        <icon id="icon_network_setting"         src="icon_network_setting.png"/>

        <icon id="icon_setting_item"           src="icon_setting_item.png"/>

        <!------------------------------------------------------------------------------------------------------- XMB Game column -->

        <icon id="icon_savedata_minis"         src="icon_savedata_minis.png"/>

        <icon id="icon_vmc"                     src="icon_vmc.png"/>

        <icon id="icon_newvmc"                 src="icon_newvmc.png"/>

        <icon id="icon_trophy"                 src="icon_trophy.png"/>

        <!------------------------------------------------------------------------------------------------------- XMB Network column -->

        <icon id="icon_onlinemanual"            src="icon_onlinemanual.png"/>

        <icon id="icon_remoteplay"             src="icon_remoteplay.png"/>

        <icon id="icon_inet_search"             src="icon_inet_search.png"/>

        <icon id="icon_browser"                src="icon_browser.png"/>

        <!------------------------------------------------------------------------------------------------------- XMB PSN column -->

        <icon id="icon_accountmanage"           src="icon_accountmanage.png"/>

        <!------------------------------------------------------------------------------------------------------- XMB Friends column -->

        <icon id="icon_blocklist"               src="icon_blocklist.png"/>

        <icon id="icon_addfriend"               src="icon_addfriend.png"/>

        <icon id="icon_playermet"               src="icon_playermet.png"/>

        <icon id="icon_chat"                   src="icon_chat.png"/>

        <icon id="icon_chatroom"                src="icon_chatroom.png"/>

        <icon id="icon_chatroom_text"           src="icon_chatroom_text.png"/>

        <icon id="icon_mbox"                   src="icon_mbox.png"/>

        <icon id="icon_mbox_received"           src="icon_mbox_received.png"/>

        <icon id="icon_mbox_sent"               src="icon_mbox_sent.png"/>

        <icon id="icon_mbox_create"             src="icon_mbox_create.png"/>

        <!------------------------------------------------------------------------------------------------------- Default icons -->

        <icon id="icon_default_h"               src="icon_default_h.png"/>

        <icon id="icon_default_v"               src="icon_default_v.png"/>

        <icon id="icon_photo_default"           src="icon_photo_default.png"/>

        <icon id="icon_photo_album_default"     src="icon_photo_album_default.png"/>

        <icon id="icon_music_default"          src="icon_music_default.png"/>

        <icon id="icon_music_album_default"     src="icon_music_album_default.png"/>

        <icon id="icon_video_default"           src="icon_video_default.png"/>

        <icon id="icon_video_album_default"    src="icon_video_album_default.png"/>

        <!------------------------------------------------------------------------------------------------------- Devices -->

        <icon id="icon_ms"                     src="icon_ms.png"/>

        <icon id="icon_sd"                     src="icon_sd.png"/>

        <icon id="icon_cf"                     src="icon_cf.png"/>

        <icon id="icon_usb"                     src="icon_usb.png"/>

        <icon id="icon_psp"                    src="icon_psp.png"/>

        <icon id="icon_pspms"                   src="icon_pspms.png"/>

        <icon id="icon_usbcamera"               src="icon_usbcamera.png"/>

        <icon id="icon_usbaad"                 src="icon_usbaad.png"/>

        <!------------------------------------------------------------------------------------------------------- Media players -->

        <icon id="icon_playing"                src="icon_playing.png"/>

        <icon id="icon_mediaserver_search"      src="icon_mediaserver_search.png"/>

<!--------------------------------------------------------------------------------------------------------------- Mouse pointers -->

        <pointer id="pointer_arrow"            src="pointer_arrow.png"    base_x="20"    base_y="5"/>    <!-- Arrow (default) -->

        <pointer id="pointer_pen"              src="pointer_pen.png"      base_x="5"      base_y="40"/>    <!-- Pen (text input) -->

        <pointer id="pointer_finger"            src="pointer_finger.png"    base_x="15"    base_y="10"/>    <!-- Hand Over Clickable Object -->

        <pointer id="pointer_click"             src="pointer_click.png"    base_x="15"    base_y="10"/>   <!-- Hand Clicking Object -->

        <pointer id="pointer_hand"              src="pointer_hand.png"      base_x="25"    base_y="20"/>    <!-- Hand Over Draggable Object -->

        <pointer id="pointer_grab"              src="pointer_grab.png"      base_x="25"    base_y="20"/>    <!-- Hand Dragging Object -->

<!--------------------------------------------------------------------------------------------------------------- Notification window -->

<!--------------------------------------------------------------------------------------------------------------- Navigation sounds -->

        <se id="se_cursor"                      src="se_cursor.vag"/>                                        <!-- Cursor movements: left, right, up, down -->

<!--------------------------------------------------------------------------------------------------------------- Color (1 to 12: color of a month, 0: changes with the month) -->

    <color selection="10"/>

*'''<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: [[Template:PlayStation Languages|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)

{{Boxcode|title=Theme_name.xml (section sample)|code=<syntaxhighlight lang="xml">

    <infotable>

            <!-- default info -->

        <info

            name="Theme Name"

            comment="No comment, thxbye"

        />

            <!-- localized info to replace for spanish language ("letter code "es") -->

        <localizedinfo

            locale="es"

            name="Nombre del tema"

            comment="No comentarios, graciasadios"

        />

    </infotable>

| icon_photo_default || rowspan="2" | 170x128, 32-bit .PNG || icon for photo without preview

| icon_video_default || rowspan="2" | 228x128, 32-bit .PNG || icon for video without preview

| icon_video_album_default || icon for folder with videos

| icon_game_default || | 322x178, 32-bit .PNG || icon for game without ICON0.PNG

| icon_game_album_default || 314x178, 32-bit .PNG || icon for game group

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 length 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.

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

{{Boxcode|title=Fake Stereo Sounds (same sound used in left and right channels|code=<syntaxhighlight lang="xml">

    <setable>

        <se id="se_system_ok"             left="se_system_ok.vag"         right="se_system_ok.vag"/>

        <se id="se_decide"                 left="se_decide.vag"             right="se_decide.vag"/>

        <se id="se_cancel"                 left="se_cancel.vag"             right="se_cancel.vag"/>

        <se id="se_optionmenu"             left="se_optionmenu.vag"         right="se_optionmenu.vag"/>

        <se id="se_cursor"                 left="se_cursor.vag"             right="se_cursor.vag"/>

    </setable>

{{Boxcode|title=Stereo Sounds (separated sounds for left and right channels)|code=<syntaxhighlight lang="xml">

    <setable>

        <se id="se_system_ok"             left="se_system_ok_left.vag"     right="se_system_ok_right.vag"/>

        <se id="se_decide"                 left="se_decide_left.vag"       right="se_decide_right.vag"/>

        <se id="se_cancel"                 left="se_cancel_left.vag"       right="se_cancel_right.vag"/>

        <se id="se_optionmenu"             left="se_optionmenu_left.vag"   right="se_optionmenu_right.vag"/>

        <se id="se_cursor"                 left="se_cursor_left.vag"       right="se_cursor_right.vag"/>

    </setable>

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")

{| class="wikitable" style="text-align:center; margin:auto"

|+Backgrounds sizes

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

{{Boxcode|code=<syntaxhighlight lang="xml">

    <bgimagetable>

        <bgimage                 hd="bg_hd_1.jpg"         sd="bg_sd_1.jpg"/>

    </bgimagetable>

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

{{Boxcode|code=<syntaxhighlight lang="xml">

        <bgimage                hd="bg_hd_1.jpg"         sd="bg_sd_1.jpg"/>

====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"

{{Boxcode|code=<syntaxhighlight lang="xml">

<!-------------------------- Backgrounds linked to PS3 time (hours of the day). Time in "HH" Format -------------------------->

    <bgimagetable showtype="datetime">

        <bgimage                 hd="bg_hd_1.jpg"         sd="bg_sd_1.jpg"     from="00"       until="01"/>

        <bgimage                 hd="bg_hd_2.jpg"         sd="bg_sd_2.jpg"     from="01"       until="02"/>

        <bgimage                 hd="bg_hd_3.jpg"         sd="bg_sd_3.jpg"     from="02"       until="03"/>

    </bgimagetable>

====Backgrounds linked to PS3 time (days of months)====

{{Boxcode|code=<syntaxhighlight lang="xml">

<!-------------------------- Backgrounds linked to PS3 time (days of months). Time in MMDD Format -------------------------->

    <bgimagetable showtype="days">

        <bgimage                 hd="bg_hd_1.jpg"         sd="bg_sd_1.jpg"   from="1231"       until="1231"/>

    </bgimagetable>

====Backgrounds linked to PS3 time (days of years)====

{{Boxcode|code=<syntaxhighlight lang="xml">

<!-------------------------- Backgrounds linked to PS3 time (days of years). Time in "YYYYMMDD" Format -------------------------->

    <bgimagetable showtype="days">

        <bgimage                 hd="bg_hd_1.jpg"         sd="bg_sd_1.jpg"   from="20121231"   until="20131231"/>

    </bgimagetable>

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)]]

{{Boxcode|code=<syntaxhighlight lang="xml">

    <bgimagetable>

        <bgimage                 anim="anim_1.jpg"/>

    </bgimagetable>

===Combined background methods===

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

        <bgimage                hd="hd_safe.jpg"          sd="sd_safe.jpg"        from="99991231"        until="99991231"/>

        <bgimage                hd="hd_1.jpg"            sd="sd_1.jpg"            from="20100101"        until="20200101"/>

        <bgimage                hd="hd_win.jpg"          sd="sd_win.jpg"          from="0101"            until="0101"/>

    </bgimagetable>

</syntaxhighlight>}}

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

        <bgimage                hd="hd_1.jpg"            sd="sd_1.jpg"/>

        <bgimage                anim="anim_1.jpg"/>

        <bgimage                hd="hd_2.jpg"            sd="sd_2.jpg"/>

        <bgimage                anim="anim_2.jpg"/>

        <bgimage                hd="hd_3.jpg"            sd="sd_3.jpg"/>

        <bgimage                anim="anim_3.jpg"/>

See also {{talk}} page

<noinclude>[[Category:Main]]</noinclude>