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:Dreamcast VMS

From ReverseEngineering.wiki
Format
Platforms Platform:Sega Dreamcast
Extensions .vms
On this wiki Facts · Code · Notes · Topics

File header of Dreamcast VMU files (.VMS): a 0x80-byte header with two descriptions, an application id, icon count, eyecatch type and CRC-16, followed by 512-byte icon bitmaps, the eyecatch and the payload.

Overview

Every file stored in a Visual Memory Unit's file system carries this header so that the BIOS and the Dreamcast can show its title and icon. KallistiOS builds and parses it with vmu_pkg_build and vmu_pkg_parse. The field table and the CRC rule are in the two facts on this page.

The eyecatch is always 72x56 pixels; palette entries are ARGB4444. Each icon is 512 bytes (32x32 pixels, 4 bits per pixel) and the 16 icon palette entries are in the header.

Unverified: the separate .VMI descriptor file (used by tools such as Dreamcast file transfer utilities) and the VMU flash directory/FAT layout (200 blocks of 512 bytes) were not read in a source.

Related

Platform:Sega Dreamcast.

Code & repositories

See the repositories linked below.

  • https://github.com/KallistiOS/KallistiOS @ 8e704086ecd4990627b85fb4905770dfffe29c00 · license: BSD-3-Clause (declared by the contributor; GitHub's detector did not recognize a license file)
    KallistiOS: vmu_pkg.c/vmu_pkg.h VMS header, utils/scramble 1ST_READ.BIN scrambler, utils/makeip
    Tested on: source read, not run · checked 2026-10-19; last activity 2026-10-16