Explore the docs » View Demo · Report Bug · Request Feature
📚 Table of Contents
This is a Python GUI application (run from the terminal) that automatically downloads box art and preview images for your video game ROMs from the libretro-thumbnails GitHub repository.
The app matches your ROM filenames exactly — including metadata like years and publishers — and fetches the corresponding images from a pinned commit on GitHub. It automatically resizes box art images to a width of 300 pixels to fit MUOS catalogue standards, populating the box and preview subfolders within the MUOS /info/catalogue folder structure.
This tool is intended as an alternative to ScreenScraper, Skraper, and Scrappy — especially for Anbernic RG28XX devices that are not Wi-Fi enabled or Mac users who can’t install Skraper.
- Automatic scraping of box and preview images
- Matches ROM filenames to libretro-thumbnails project
- Supports MUOS folder structure and image resizing
- Works offline once downloaded
- Two flexible output options
⬆️ Back to top
⬆️ Back to top
These instructions will help you set up the project locally.
- An internet connection (to download artwork from GitHub)
- ROMs organized in folders (with filenames that match libretro-thumbnails)
- Knowledge of your system’s MUOS name and libretro-thumbnails folder name
Make sure Python and Pillow are installed:
python3 --version
pip install pillow- Clone the repository:
git clone https://github.com/mattsteen14/rascraper.git- Navigate into the project folder:
cd rascraper- Install dependencies:
pip install -r requirements.txt- Run the app:
python3 rascraper.py-
Select your ROMs folder using the first Browse button.
-
Select the MUOS root folder using the second Browse button (this is the MUOS directory on your SD card or computer).
-
Select the system from the dropdown. This will map to the correct libretro-thumbnails folder and MUOS
/info/catalogue/{system}folder. -
Choose your output location using the radio buttons:
- MUOS structure: Saves artwork directly to
MUOS/info/catalogue/{system}/boxandpreviewfolders. - ROMs folder: Creates an
imagesfolder withBoxartsandScreenshotssubfolders in the ROMs folder.
- MUOS structure: Saves artwork directly to
-
Click RUN SCRAPER.
-
Check the folders — artwork should be downloaded and placed correctly.
⬆️ Back to top
- Plan project
- Write code
- Test with various ROMs and output options
- Version control and GitHub setup
- Testing and debugging
- Batch scan and process all subfolders in ROMs root
- Package as a cross-platform standalone app
👉 See Issues for open features and bugs.
⬆️ Back to top
Contributions are what make open source amazing. If you'd like to help:
-
Fork the repository
-
Create your branch:
git checkout -b feature/YourFeature- Commit your changes:
git commit -m "Add some feature"- Push to GitHub:
git push origin feature/YourFeature- Open a pull request
Or open an issue with the enhancement label.
⬆️ Back to top
Distributed under the MIT License.
See LICENSE for more information.
⬆️ Back to top
Matt Steen-Brookes
📧 mattsteen14@me.com
🐦 @mattsteen14
🔗 GitHub Repo
⬆️ Back to top
- Mo Ashqar for introducing me to Codecademy
- Othneil Drew for the README template
- Choose an Open Source License
⬆️ Back to top