Guide

Getting started

Install Revolution Editor and open your first project.

What you need

  • A Mac running macOS 27 or later.
  • Your own game files: a disc image, or an extracted game folder.
  • For Wii discs, your own key.bin. The app never includes or downloads one.
  • Optional: Dolphin, a free emulator, to test your work.
Your own games only. Revolution Editor contains no Nintendo code, keys or game data.

Install

  1. Download it from GitHub.
  2. Drag Revolution Editor into your Applications folder and open it.

Add your key

The first time you open the app, a short setup asks which games to show tools for, then lets you pick your key, Dolphin and devkitPro. Every step can be skipped and changed later in Settings.

Wii discs are encrypted. Open Settings > Keys, choose your key.bin, and the app remembers it. Extracted folders and GameCube images don't need one.

Open something

  • File > Open > File… (⌘O by default) for a single file.
  • Folder… (⇧⌘O by default) for a project folder.
  • Wii/GCN Disc Image… to browse a disc.

The window has your files on the left, an editor for each file type in the middle, and a console at the bottom. The sidebar updates by itself when files change in Finder.

Folder tabs. Open more folders and each gets a tab above the sidebar; click one to switch, or its cross to close it. Opening a .szs or .arc from outside the project opens the folder it is in, with the archive already expanded (turn this off in Settings > Editing).

Welcome window and Help

Revolution Editor starts on a Welcome window with Open, Open a disc and New buttons and a list of recent projects. Reopen it any time from Window > Welcome to Revolution Editor (⇧⌘1 by default). Help > Revolution Editor Help (⌘?) links to this guide, and the Help menu also has links to the Discord server and Buy Me a Coffee.

Settings

Settings has a sidebar of panes: Games, Keys, Emulator and Homebrew (setup); Code Editor, Editing, External Editors and Agents (editing); Appearance and Controls.

Save (⌘S by default) and Save As… (⇧⌘S by default) are in the File menu and act on the tab you are in. Settings > Controls lets you change every keyboard shortcut and the mouse modifiers used in the editors (for example, box-selecting points with a plain drag instead of Shift-drag). Shortcuts and key names on these pages are the defaults; the in-app help follows your own settings.

Good to know

  • Window > To-Do keeps a list of steps and ideas for each project. Auto Fill Steps adds a starter checklist for a custom track, battle map and other kinds of mod in each game.
  • Provide Feedback at the top of Settings sends a bug report or feature suggestion.
  • Every editor has Undo and a History list you can jump around in.
  • Right-click a file or folder for New, Rename, Duplicate, Extract and more.
  • Settings is where you link your own game discs, set the Dolphin location and choose how models are built.