Getting Started

Getting Started

This guide will help you set up and run the Tutankham ROM Editor for the first time.

Installation

Step 1: Install Python

Download and install Python 3.13.7 or newer from https://www.python.org/

Step 2: Install Required Packages

Open a terminal/command prompt in the editor folder and run:

pip install -r requirements.txt

This installs:

• numpy - Array processing
• Pillow - Image handling
• colorlog - Colored logging output
• webcolors - Color name conversion

Step 3: Obtain ROM Files (Legally Obtain)

You need the MAME fully merged Tutankham ROM zip file. Place tutankhm.zip in the same folder as TutankhamEditor.py.

The zip should contain ROMs for all three variants:

• Konami (original Japanese)
• Stern (US licensed)
• Bootleg (unofficial)

At a minimum, you will need the full Konami set, as that is the default for the editor.

Step 4: Run the Editor

python TutankhamEditor.py

First Launch

When you first run the editor:

1. ROMs are automatically loaded from tutankhm.zip
2. The Konami ROM set is selected by default
3. All data is loaded into memory (ROMs are not modified)
4. Status bar shows "Ready - Select an editor from the menu"

ROM Set Selection

Change ROM sets using the dropdown on the main window:

Opening Editors

Access editors from the Editors menu:

Saving Your Work

IMPORTANT: The editor does NOT auto-save! You must manually save your changes.

From the File menu, choose:

• Save ROMs - Overwrites files in current directory
• Save ROMs To Folder - Saves to a selected location

Testing Your Edits

To test modified ROMs in MAME:

1. Create a tutankhm subfolder
2. Extract the original zip to this folder
3. Save your modified ROMs to this folder
4. Run: mame -window tutankhm -rompath .

Next Steps

• Map Editor - Start designing custom maps
• Palette Editor - Create custom color schemes
• Tips and Tricks - Learn advanced techniques