👾 MyriFetch

MyriFetch is a modern, high-performance ROM manager and downloader designed specifically for the Myrient (Erista) repository. It replaces manual browser downloads with a sleek, dark-mode GUI capable of browsing, queuing, and accelerating downloads via multi-threading.

✨ Features

• 🚀 "Hydra" Download Engine: Splits files into 4 parallel chunks (threads) to maximize bandwidth and bypass single-stream speed limits.
• 📦 Bulk Queue System: Select multiple games, add them to a 100-item batch queue, and let it run in the background.
• 🏆 RetroAchievements Integration: Connect your RA account to view your profile stats, points, and rank directly within the app.
• 🎨 IGDB Metadata & Box Art: Integrated with Twitch/IGDB API to automatically fetch high-quality box art, descriptions, genres, and release dates for your library.
• 💾 Smart Resume & Integrity: Checks file sizes and stitches parts automatically. Includes "Pause," "Resume," and "Stop" features for safe download management.
• 📂 Library Manager: Scan your local folders to view your collection, see what you're missing, and open file locations directly from the app.
• 🛠️ BIOS Downloader: One-click downloads for essential RetroArch and emulator BIOS packs.
• 🐧 Cross-Platform: Runs natively on Windows, Linux, and macOS.

🎮 Supported Platforms

• Sony PlayStation 1, 2, 3 & PSP
• Nintendo GameCube, Wii, 3DS, DS, GBA, SNES
• Sega Dreamcast
• Microsoft Xbox
• And more via the custom folder browser...

🛠️ Installation & Usage

Windows

1. Download the latest MyriFetch-Windows.exe from the [Releases] page.
2. Run the executable.
3. Setup: Go to Settings to map your console folders and enter your Twitch/RA API keys for the full experience.

Linux

1. Download MyriFetch-Linux-Appimage.AppImage.
2. Make it executable: chmod +x MyriFetch-Linux-Appimage.AppImage.
3. Run MyriFetch-Linux-Appimage.AppImage.
4. Setup: Go to Settings to map your console folders and enter your Twitch/RA API keys for the full experience.

macOS

1. Download MyriFetch-macOS.
2. Open your terminal and navigate to the download location.
3. Make the script executable: chmod +x MyriFetch-macOS.
4. Run the script: ./MyriFetch-macOS.
5. Setup: Go to Settings to map your console folders and enter your Twitch/RA API keys for the full experience.

💿 CHDman Usage

Windows

For safety and security reasons, this repository does not include the chdman.exe executable. Since you cannot always trust third-party binaries and repositories, it is best to download it yourself directly from the official source. This also ensures you get the most recent and compatible version.

1. Go to the official MAME tools download page, download and install MAME.
2. Go to the CHDman section in settings and select the path to CHDman (where you installed the tools to).
3. Turn on compression per system (PS1, PS2, PSP and Dreamcast).

Linux

On most distributions, chdman is bundled with the mame-tools package.

Method 1: Native Package Manager

1. Open your terminal.
2. Run the command for your distribution:

Debian / Ubuntu / Linux Mint:

sudo apt install mame-tools

Arch Linux / Manjaro:

sudo pacman -S mame-tools

Fedora:

sudo dnf install mame-tools

Method 2: Homebrew (Alternative)

Alternatively, if you use Homebrew on Linux:

1. Open Terminal.
2. Run the following command:

brew install rom-tools

3. Once installed, the program should recognise where the executable is located.

MacOS

On macOS, chdman is available through Homebrew in the rom-tools package.

1. Open Terminal.
2. Install Homebrew if you haven't already (https://brew.sh).
3. Run the following command:

brew install rom-tools

🏗️ Building from Source

Requirements: Python 3.10+, pip

# Clone the repo
git clone https://github.com/CrabbieMike/MyriFetch.git
cd MyriFetch

# Install dependencies
pip install -r requirements.txt

# Run
python MyriFetch.py

⚙️ Advanced Customization

The Settings menu allows you to:

• Theme Switching: Choose between Cyber Dark, Nord, Gruvbox, and Matrix themes.
• Browser Text Size: Adjust the UI font size for better readability on high-resolution displays.
• Content Filters: Toggle filters for Demos and Revision files to keep your search results clean.
• Storage Monitoring: Real-time tracking of free space on your mapped drives.

⚠️ Disclaimer

This software is for archival and preservation purposes only. The developer is not affiliated with Myrient/Erista or RetroAchievements. Please support the original hardware and developers when possible.