strugglechen1337/thorrombutler — explained in plain English
Analysis updated 2026-05-18
Automatically sort a folder of downloaded ROM archives into the correct system folders for a retro handheld like the AYN Thor or Retroid Pocket.
Apply an IPS or UPS fan translation patch to a ROM directly on the device without a computer.
Run a health check on an existing ROM library to find misfiled games, broken multi-disc playlists, or missing BIOS files.
| strugglechen1337/thorrombutler | android-hacker/wechatchatroomhelper | danmoreng/qwen3-tts-android | |
|---|---|---|---|
| Stars | 7 | 8 | 6 |
| Language | Kotlin | Kotlin | Kotlin |
| Last pushed | — | 2019-12-09 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | easy | hard | hard |
| Complexity | 2/5 | 4/5 | 4/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Android 13 or newer, distributed via GitHub Releases, not the Play Store.
Thor ROM Butler is an Android app for organizing a retro gaming ROM collection. It watches for downloaded ROM archives on the device, looks inside them without fully extracting the files, figures out which game system each ROM belongs to, and moves it into the correct folder for frontends like EmulationStation-DE, Batocera, or Onion OS. It is built with handheld devices like the AYN Thor and Odin, and the Retroid Pocket in mind, but it runs on any Android phone running Android 13 or newer. Detection works by reading file extensions and file headers, including special handling for ISO, RVZ, and CHD disc image formats, and the app is explicit about how confident it is in each match: sure, likely, or unknown. Files it cannot confidently identify are never moved automatically, the user always reviews and confirms suggestions, either one at a time or by accepting them all at once. The app can also learn locally from a person's past manual choices to suggest similar files later, and that learning can be turned off or cleared entirely. Beyond basic sorting, the app includes a Library Doctor that checks for ROMs filed in the wrong place, broken multi-disc playlist references, unreadable archive files, and missing BIOS or firmware files, and it can safely repair many of these issues. It can also apply IPS, UPS, and BPS patches directly on the device, useful for fan translations and ROM hacks, verify ROMs against No-Intro or Redump checksum databases, generate playlists for multi-disc games automatically, and back up an entire ROM library to an SD card or USB drive incrementally. A local network receive feature lets someone drag files from a computer's browser straight onto the device over Wi-Fi, complete with a QR code and progress tracking. The app supports a long list of classic systems from the NES through the PlayStation 2, GameCube, Wii, Switch, and several arcade formats, with the option to add more systems as local JSON packs. It is free, open source, distributed through GitHub Releases rather than the Play Store, and the interface is available in German and English under a dark, neon-themed design. The project is released under the MIT license.
Thor ROM Butler is an Android app that detects, identifies, and sorts retro game ROM files into the correct EmulationStation-DE, Batocera, or Onion OS folders, always asking for confirmation first.
Mainly Kotlin. The stack also includes Kotlin, Android, Jetpack Compose.
MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.