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:Wii CISO (Dolphin)

From ReverseEngineering.wiki
Format
Platforms Platform:Nintendo GameCube, Platform:Nintendo Wii
Magic 43 49 53 4F (CISO)
Extensions .ciso
Endianness little
On this wiki Facts · Code · Notes · Topics

The CISO container that Dolphin reads for GameCube/Wii discs (magic CISO, little-endian block size at 4, a 0x7FF8-byte used-block map, data at 0x8000): not the PSP CSO format, which shares the first four bytes.

Overview

Dolphin's CISO reader handles a sparse disc image: a 0x8000-byte header with a byte map saying which fixed-size blocks of the disc are present, followed by those blocks back to back. It starts with the same four bytes CISO as the PSP compressed ISO (Format:CSO (compressed ISO)), but the two are different formats; a tool must separate them by what follows. Source: dolphin-emu/dolphin (GPL-2.0-or-later) Source/Core/DiscIO/CISOBlob.h and CISOBlob.cpp at commit 41460454e9600f909950fddf0abd13a138430162.

Layout

  • CISO_HEADER_SIZE = 0x8000. struct CISOHeader: u32 magic (CISO_MAGIC 0x4F534943, bytes 43 49 53 4F), u32 block_size (little endian), then map[CISO_MAP_SIZE] with CISO_MAP_SIZE = 0x8000 - 4 - 4 = 0x7FF8 bytes.
  • map[i] is 1 when block i of the disc is present, 0 when absent; other values are called invalid in the header comment, and the reader treats everything except 1 as absent.
  • Present blocks are numbered in map order; block k in the file is at 0x8000 + k * block_size. Absent blocks read as zeros. Reads beyond block 0x7FF7 also read as zeros, and the data size reported is 0x7FF8 * block_size (an upper bound).
  • Nothing is compressed: the format only drops unused blocks. There is no compression method or level.

Telling it from PSP CSO

PSP CSO has a 0x18-byte header with header_size 0x18 at offset 4, a 64-bit uncompressed size at 8 and an index table after the header; ZSO uses the magic ZISO. In the Wii format offset 4 is the block size (typically a large power of two) and the byte map starts at offset 8. Dolphin's CISOFileReader::Create checks only the magic, so the format cannot be told from the first four bytes. Unverified: the block_size values written by common Wii tools (Dolphin only reads this format); read offset 4 of a real file.

Related

Format:GCZ, Format:WIA and RVZ, Format:WBFS disc container, Format:GCM disc image (GameCube and Wii).

Code & repositories

  • https://github.com/dolphin-emu/dolphin @ 41460454e9600f909950fddf0abd13a138430162 · license: GPL-2.0-or-later (declared by the contributor; GitHub's detector did not recognize COPYING)
    Source/Core/DiscIO/CompressedBlob.h/.cpp (GCZ), CISOBlob.h/.cpp (Wii CISO) and Blob.cpp (container detection by first u32)
    Tested on: source read, not run · checked 2026-10-19; last activity 2026-10-18