myrient-cli is a terminal-based interactive CLI tool for browsing and downloading retro game dumps from the Myrient Redump mirror. It allows you to navigate platforms, search for titles, queue multiple downloads, and automatically extract the games.
- Interactive menu to select a gaming platform (PS2, GameCube, Dreamcast, etc.)
- Live search/filter by game title, with regex support
- Paginated browsing
- Queue and download games sequentially for reliability
- Summary messages for queued downloads
- Pretty progress bars (download + unzip)
- Automatic
.zipextraction and cleanup - Customizable download directory
- Go 1.22+
- Terminal (Linux, macOS, Windows)
In the project root, run:
makeThis will build binaries for:
- Linux (amd64, arm, arm64)
- macOS (amd64, arm64)
- Windows (amd64, arm64)
Binaries are placed in the builds/ directory.
To clean old builds:
make cleanFrom terminal:
./myrient-cliThe CLI will walk you through:
- Selecting a platform
- Filtering titles (supports regex: e.g.
(?i)halo.*usa) - Browsing the game list (with pagination)
- Queuing downloads (all, or by number)
- Watching progress as files are downloaded and extracted
- Viewing summary messages for queued downloads
- Regex filtering for advanced search
- Sequential download queue (no more concurrency errors)
- Clear summary messages after queuing downloads
- All map accesses are now concurrency-safe
You can use regular expressions to filter game titles in the CLI:
- Enter a regex pattern to match titles (e.g.
^Halo.*USA) - Use
|for OR (e.g.Mario|Zelda) - Use
(?i)for case-insensitive matching (e.g.(?i)halo) - To match titles containing both "halo" and "usa" in any order:
(?i).*halo.*usa.*|.*usa.*halo.* - Leave the filter empty to reset and show all games
Examples:
| Pattern | Matches |
|---|---|
| `Mario | Zelda` |
^Super |
Titles starting with "Super" |
64$ |
Titles ending with "64" |
(?i)halo |
Any case "halo" |
(?i).*halo.*usa.* |
Titles with both "halo" and "usa" |
If your regex is invalid, the filter will fall back to a simple substring search.
- Regex filtering for advanced search
- Sequential download queue (no more concurrency errors)
- Clear summary messages after queuing downloads
- All map accesses are now concurrency-safe
By default, games are downloaded to:
./.downloads/
To override this path, set an environment variable:
export MYRIENT_DOWNLOADS_PATH=/path/to/your/folderThe tool will automatically create the folder if it doesn't exist.
MIT – feel free to use, modify, and share.