Simple, easy to understand explanations of the XML them file variables and available options.

Playstation Vita Theme Guide.md

Playstation Vita Theme Guide

I haven't been able to find any documentation for the Playstation Vita Theme variables and details like their expected values. I'm also listing all information about the file requirements for the theme files. I will try my best to explain what specific variables are used for, their value types and options, and the file requirements for those PNGs.

XML Variables

Variable Types

Simple breakdown of the types I'll be using below:

• color: 8 character hexcodes, string
• path: Relative file path, string

Date Layout Options

All available options for the m_dateLayout variable:

• 0: Places date and time towards bottom left
• 1: Places date and time towards top left
• 2: Places date and time towards bottom right

Page Text Shadow Options

All available options for the m_fontShadow variable:

• 0: Adds light text shadow to text on page
• 1: Adds dark text shadow to text on page

Wave Type Options

A full list with previews of the options for the m_waveType variable are available on this gist by Scrxtchy.

Status Bar

Status bar variables should be nested under the theme > InfomationBarProperty tag. The available variables are listed below:

Variable	Type	Description
m_barColor	color	Controls the color of the status bar background
m_indicatorColor	color	Controls the color of the status bar text and icons.
m_noticeFontColor	color	Controls the color of the notification bubble count.
m_noticeGlowColor	color	Controls the color of the notification bubble glow.
m_noNoticeFilePath	color	File path to the "No Notifications" state of the notification bubble.
m_newNoticeFilePath	color	File path to the "New Notifications" state of the notification bubble.

Lock Screen

Lock screen variables should be nested under the theme > StartScreenProperty tag. The available variables are listed below:

Variable	Type	Description
m_dateLayout	int	Controls the placement of the date and time. Options: 1, 2, 3.
m_dateColor	color	Controls the color of the date and time font.
m_notifyFontColor	color	Controls the color of the notification tray font.
m_notifyBgColor	color	Controls the color of the notification tray background.
m_notifyBorderColor	color	Controls the color of the notification tray border.
m_filePath	path	File path to the lockscreen wallpaper.

Home Screen

Home screen variables should be nested under the theme > HomeProperty tag. Home screen has multiple uses in the theme.xml file, you can use it for page properties, background music, page dots and app icons.

Pages

Home screen page variables should be nested under the theme > HomeProperty > m_bgParam > BackgroundParam tag. The available variables are listed below:

Variable	Type	Description
m_waveType	int	Controls the background waves type when transitioning between pages. Options: 0 - 30.
m_fontColor	color	Controls the color of the pages font.
m_fontShadow	int	Controls the color of the pages text shadow. Options: 0, 1.
m_imageFilePath	path	File path to the pages wallpaper.
m_thumbnailFilePath	path	File path to the pages wallpaper thumbnail. (used for previews)

App Icons

Home screen icon tags should be nested under the theme > HomeProperty tag. The available tags are listed below, as well as the available variables:

Tag	Description
m_browser	Tag for "Browser" app.
m_calendar	Tag for "Calendar" app.
m_camera	Tag for "Photos" app.
m_email	Tag for "Email" app.
m_friend	Tag for "Friends" app.
m_hostCollabo	Tag for "Content Manager" app.
m_message	Tag for "Messages" app.
m_music	Tag for "Music" app.
m_near	Tag for "Near" app.
m_parental	Tag for "Parental Controls" app.
m_party	Tag for "Party" app.
m_power	Tag for "Power" app.
m_ps3Link	Tag for "PS3 Remote Play" app.
m_ps4Link	Tag for "PS3 Link" app.
m_settings	Tag for "Settings" app.
m_trophy	Tag for "Trophies" app.
m_video	Tag for "Videos" app.

Home screen icon variables should be nested under the theme > HomeProperty > m_exampleTag > m_iconFilePath tag.

Variable	Type	Description
m_iconFilePath	path	File path to the home screen icon.

Page Dots

Home screen page dot variables should be nested under the theme > HomeProperty tag. The available variables are listed below:

Variable	Type	Description
m_basePageFilePath	path	File path to the inactive page dot state.
m_curPageFilePath	path	File path to the active page dot state.

Background Music

Home screen page dot variables should be nested under the theme > HomeProperty tag. The available variables are listed below:

Variable	Type	Description
m_bgmFilePath	path	File path to the background music.

File Requirements

App Icons

The following file requirements are specifically for the app icons:

• Format: PNG
• Size: 128px × 128px

Lock Screen Wallpaper

The following file requirements are specifically for the lock screen wallpaper:

• Format: PNG
• Size: 960px × 544px or 840px × 512px
• Color Deptch: 8 bit
• Colors: Up to 128

Home Screen Wallpapers

The following file requirements are specifically for the home screen wallpapers:

• Format: PNG
• Size: 960px × 512px
• Color Deptch: 8 bit
• Colors: Up to 128

Wallpaper Preview Thumbnails

The following file requirements are specifically for the wallpaper preview thumbnails:

• Format: PNG
• Size: 226px × 128px

Lock Screen & Home Screen Previews

The following file requirements are specifically for the wallpaper preview thumbnails:

• Format: PNG
• Size: 320px × 181px

Background Music

Background music needs to be a .wav file compressed as a .at9 file using the at9tool or similar. The following file requirements are specifically for the background music:

• Format: WAV
• Type: WAV (Microsoft) signed 16-bit PCM
• Size: 18MB
• Final Format: AT9
• Final Size: 2MB

If I'm missing any known variables or tags please comment below and where they belong in the structure. I'll add them here once I verify them on a Vita.