Cheat Editor Manager Tool is a Windows desktop app for editing cheat files and exporting them to the folder layout expected by emulators, CFW setups, and homebrew targets.
It is built for users who already have cheat text and want a cleaner way to load it, edit it, fill the required IDs, preview the output path, and save it in the right place.
Download the latest Windows build from the releases page:
- Lets you write, paste, load, clean up, and save cheat text
- Detects supported IDs from known file paths where possible
- Shows the required TID, BID, CRC, serial, title ID, or core fields for the selected target
- Builds the correct output path before writing files
- Exports quickly to the expected emulator or CFW folder layout
- Keeps manual Convert & Save available when you want full control
- Saves reusable cheat snippets as templates
- Saves cheat source websites in Help Links
- Keeps custom emulator profiles separate from built-in CFW profiles
- Open the app.
- Choose a target group, such as CFW / Homebrew, PC / Emulator, or Custom Emulators.
- Choose the target profile, such as Atmosphere, Ryujinx, PCSX2, RetroArch, or Dolphin.
- Click Load File or paste cheat text into the editor.
- Check the Helper panel for required IDs and the export preview.
- Fill any missing ID fields.
- Click Quick Export to save to the correct profile layout.
Use Convert & Save when you want to choose the save location and file extension yourself.
- Atmosphere (Switch CFW)
- Yuzu
- Ryujinx
- Sudachi
- Suyu
- Citra (3DS)
- RetroArch
- Dolphin
- PCSX2
- PPSSPP
- DuckStation
- Cemu
- Xenia
- RPCS3
- Nintendo 3DS (Luma)
- PSP (CFW)
- PS Vita (taiHEN)
- Wii (Homebrew)
- Wii U (CFW)
User-added emulator profiles appear under Custom Emulators so they do not get mixed into the hardcoded CFW layouts.
- Header: app identity, light/dark mode, Templates, Help Links, and Settings.
- Target controls: target group, target profile, profile details, and export root controls.
- Helper panel: required ID fields, profile notes, and live export preview.
- Cheat editor: the main text area with undo, redo, clear, wrap, scrolling, and optional drag-and-drop.
- Action bar: Load File, Quick Export, Convert & Save, and current status.
- Templates: saved cheat text snippets that can be edited and loaded into the editor.
- Help Links: saved cheat source websites where users found codes or notes. The app opens links in the browser; it does not download cheats automatically.
- Settings: profiles, appearance, and export-root preferences.
When you load a cheat file, the app tries to read useful IDs from known layouts. For example:
- Switch layouts can fill TID and BID fields.
- Citra layouts can fill title IDs.
- Dolphin layouts can fill game IDs.
- PCSX2 layouts can fill CRC values.
If the file path does not contain enough information, the app leaves the fields empty and lets you enter them manually.
- It does not download cheats automatically.
- It does not inject cheats into games, consoles, or emulators.
- It does not require accounts, cloud sync, API keys, or online services.
- It does not replace emulator-specific cheat validation tools.
The app stores preferences locally on the computer. This includes custom profiles, templates, Help Links, appearance settings, RetroArch core choices, and export-root overrides.
Built-in profiles are protected so CFW and emulator layouts stay reliable. Custom profiles are intended for extra emulator-only export rules.
Use Python 3.10 or newer.
python -m pip install -e ".[dev]"
python cheat_editor_manager_tool.pyPackage entry point:
python -m cheat_editor_managerOptional drag-and-drop support:
python -m pip install -e ".[dev,dnd]"tkinterdnd2 is optional. If it is not installed, the app still runs and uses the normal Load File button.
Run the full test suite:
python -B -m unittest discover -s tests -p "test*.py" -qThe smoke tests can launch the app in a safe one-shot mode:
$env:CHEAT_EDITOR_MANAGER_SMOKE_EXIT = "1"
python -B cheat_editor_manager_tool.pyCompile check:
python -B -m compileall -q assets/generate_brand_assets.py cheat_editor_manager tests hookspython -m PyInstaller --clean --noconfirm cheat_editor_manager_tool.specOutput:
dist/cheat_editor_manager_tool.exe
The build uses the custom Tk/Tcl hooks in hooks/ and vendored Tcl/Tk runtime files in vendor/tcl/.
The codebase is organised so UI, app logic, storage, and export rules are easier to maintain separately.
cheat_editor_manager/
app.py App startup and main wiring
app_actions.py Thin UI callback wrappers
export_logic.py Pure export/path rules
profiles.py Built-in and custom profile helpers
services/ Export, loading, help-link, core, and theme services
storage/ Preferences and template storage
ui/ Panels, dialogs, widgets, style, and theme code
tests/ Logic, storage, service, and GUI smoke tests
assets/ App icons, screenshots, logos, and brand files
hooks/ PyInstaller Tk/Tcl packaging hooks
vendor/tcl/ Vendored Tcl/Tk runtime files
Keep new export rules in export_logic.py, keep user-facing orchestration in services/, keep saved data handling in storage/, and keep visual UI work in ui/.
- Add more emulator or CFW targets through the profile/export rule system.
- Add stronger ID detection for more known cheat folder layouts.
- Improve template management with categories or search if the list grows.
- Add more focused tests whenever a new export layout is added.
- Keep dialogs small and section-based so Settings, Templates, and Help Links stay easy to use.
- This README explains what the program does and how to run it.
- assets/README.md explains runtime assets, retained brand-source files, and screenshot usage.
- Source runs require Python with Tkinter support.
- Drag-and-drop requires optional
tkinterdnd2. - Export correctness still depends on choosing the right target profile and entering the required IDs.
MIT License. See LICENSE.
