Skip to content

rom-manager

ecosystem — convert game ROMs to CHD/RVZ, extract archives, auto-rename via known game codes, and generate cue sheets.

Official documentation

This site is the canonical reference for rom-manager, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

rom-manager wraps a local ROM conversion pipeline with typed, deterministic MCP

  • RomManager — the real conversion pipeline (rom_manager.rom_manager): extract archives → rename via game codes → convert ISO/WBFS to CHD/RVZ via chdman/dolphin-tool → cleanup.
  • Action-routed MCP tools — two consolidated, togglable domains (conversion, game-codes) that minimize token overhead in LLM contexts.

This is a local tool: there is no service URL and no credentials. Conversion actions require the external chdman (mame-tools), dolphin-tool, and 7z binaries.

Explore the documentation

  • :material-rocket-start: Installation — pip, source, extras, external binaries, and Docker.
  • Usage — the MCP tools, the Api facade, and the CLI.
  • Overview — the action-routed tool surface and architecture.
  • Concepts — the CONCEPT:ROM-* registry.

Quick start

pip install "rom-manager[mcp]"
rom-manager-mcp                   # stdio MCP server (default transport)

Convert a directory of ROMs from the CLI:

rom-manager --directory "/games/PSX/" --iso chd --verbose