Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:CSO (compressed ISO)

From ReverseEngineering.wiki
Format
Platforms Platform:PlayStation Portable
Magic 43 49 53 4F (CISO) / 5A 49 53 4F (ZISO)
Extensions .cso, .zso
Endianness little
On this wiki Facts · Code · Notes · Topics

Block-compressed disc image of PSP UMD ISOs (.cso, magic CISO; .zso, magic ZISO): a 0x18-byte little-endian header, an index of u32 offsets (shifted by index_shift, high bit = block stored uncompressed) and raw deflate (CSO) or LZ4 (ZSO) blocks of usually 2048 bytes.

Overview

A CSO holds the plain ISO 9660 image of a UMD (Format:PSP UMD disc layout) cut into fixed blocks, each stored deflate-compressed or raw. Emulators such as PPSSPP read it directly; the original tool was by BOOSTER, maxcso is the best documented modern writer. After decompression the data is an ordinary Format:ISO 9660 image.

Header (0x18 bytes, little endian)

Offset Size Field
0x00 4 magic CISO (ZISO for ZSO)
0x04 4 header_size (0x18; not reliable in v1 files, PPSSPP ignores it for version 0 and 1)
0x08 8 uncompressed_size (bytes of the original ISO)
0x10 4 block_size (usually 2048)
0x14 1 version (0 or 1; 2 is the experimental maxcso v2)
0x15 1 index_shift (called align in PPSSPP)
0x16 2 unused

Index and blocks

ceil(uncompressed_size / block_size) + 1 u32 entries follow the header. The low 31 bits shifted left by index_shift give the file offset of a block; the block length is the next entry minus this one (so it may include padding when index_shift > 0). The high bit marks a block stored uncompressed. The last entry is the end of the data, normally the end of the file. Entries must be non-decreasing. CSO blocks are raw deflate (zlib window -15, no zlib header); ZSO blocks are LZ4.

Versions

  • v1 (version byte 0 or 1): as above.
  • ZSO (ZISO, proposed by codestation for PRO CFW): same layout as v1 with LZ4 blocks, header_size 0x18, version 1.
  • maxcso v2 (experimental): a block whose stored length is >= block_size must be raw; shorter blocks are compressed and the high bit then selects LZ4 (set) or deflate (clear). PPSSPP's source says CSOv2 was never in active use and refuses version > 1.

Reading notes

PPSSPP requires a power-of-two block_size of at least 0x800, rejects index_shift above 20, and checks that the last index entry does not point past the end of the file. It does not read ZISO (it only tests for CISO).

PPSSPP's BlockDevices.cpp at the pinned commit has no match for DAX or ZISO (a case-insensitive search found neither; it tests the four bytes CISO at line 247). Unverified: DAX (.dax), another compressed UMD format that other tools read; no header layout was read for this page. Dolphin's CISO for Wii discs is a different format: see Format:Wii CISO (Dolphin).

Identification

First four bytes CISO or ZISO, with the index table starting at offset 0x18 in files written with the standard header.

Code & repositories

  • https://github.com/hrydgard/ppsspp @ 0c6aa15f9be365bb88265636881814914ee8ac58 · license: GPL-2.0 (declared by the contributor for the files used; GitHub reports BSD-2-Clause (read from LICENSE.TXT; GitHub's detector did not classify it) for the repository)
    PSP emulator (GPL-2.0): Core/ELF/ParamSFO.cpp (SFO read/write), Core/FileSystems/BlockDevices.cpp (CSO, NPDRM PBP), Core/PSPLoaders.cpp (disc paths), Core/Font/PGF.h (font header)
    Tested on: source read, not run: source read, not run; raw files fetched at the pinned commit · checked 2026-10-19; last activity 2026-10-18; Note: the latest release ships binaries; the wiki links only the source, never the binaries
  • https://github.com/unknownbrackets/maxcso @ 961f232cf99d546b2b7e704c0ecf3fc5bea52221 · license: ISC (declared by the contributor; GitHub's detector did not recognize LICENSE.md)
    CSO/ZSO compressor (ISC): README_CSO.md and README_ZSO.md specify the CISO v1/v2 and ZISO headers and index
    Tested on: source read, not run: source read, not run; README_CSO.md and README_ZSO.md read at the pinned commit · checked 2026-10-19