Format:PS2 icon.sys
| Magic | PS2D (50 53 32 44) at offset 0 |
|---|---|
| Extensions | icon.sys |
| Endianness | little |
| On this wiki | Facts · Code · Notes · Topics |
The 964-byte descriptor file named icon.sys that sits in every PlayStation 2 memory card save directory beside the icon models: magic "PS2D", the byte offset where the title's second line starts, background and light settings, a 68-byte Shift-JIS title and the file names of the normal, copy and delete icons.
Overview
Every save directory on a PlayStation 2 memory card (Format:PS2 memory card image) holds an icon.sys file that the browser screen of the console reads to show the save: a title in two lines, a background gradient, lighting for the 3D icon, and the names of up to three icon model files (the .icn/.ico files in the same directory). Save exports such as .psu and .max (Format:PSU and MAX (PS2 save containers)) carry it as one of their files.
Layout
The size read by the open readers is 964 (0x3C4) bytes; see Fact:PS2 icon.sys/struct/icon.sys layout. Offsets: magic 0x00, title line-break offset 0x06, transparency 0x0C, four background corner colours 0x10-0x4F, three light directions 0x50-0x7F, three light colours 0x80-0xAF, ambient 0xB0, title 0xC0 (68 bytes, Shift-JIS), normal icon file name 0x104, copy icon 0x144, delete icon 0x184 (64 bytes each), 512 reserved bytes at 0x1C4.
The title is one string: the byte at secondLineOffset splits it into line 1 (before) and line 2 (from the offset on). mymc (icon_sys_title) cuts the title bytes at that offset and converts each part from Shift-JIS.
Reader differences
Readers disagree on how strict to be about the magic and the size; see Fact:PS2 icon.sys/behavior/Reader checks differ and Fact:PS2 icon.sys/magic/PS2D. A tool should read the first 964 bytes and tolerate a longer file (the Apollo code mentions a 976-byte icon.sys).
Icon models
Unverified: the files named in icon.sys are the 3D icon models (commonly with the extension .icn or .ico) that start with the magic 0x00010000 (little endian) and hold vertices, normals, UVs and a 128x128 16-bit texture with optional animation. No source for the .icn layout was read here; mymc's native icon renderer (mymcicon) is the open reference to read next.
Not covered
I did not read how the console firmware itself validates icon.sys. The PCSX2 folder memory card code (MemoryCardFolder.cpp/.h at fc4d0cdf609e) contains no handling of icon.sys (a case-insensitive search for "icon" found only an OSD message icon include).
Code & repositories
- https://github.com/ps2dev/mymc @
db5d9e1c141cbbc4ba4e374f73a0518a8d75b7ef· license: LicenseRef-Public-Domain (declared by the contributor; GitHub's detector did not recognize a license file)
Python PS2 memory card manager by Ross Ridge; ps2save.py (icon.sys unpack, PSU/MAX/EMS saves) and ps2mc.py (card file system) are marked Public Domain in their headers; GitHub shows no license file.
Tested on: source read, not run · checked 2026-10-19; last activity 2023-07-29