An open API service indexing awesome lists of open source software.

https://github.com/stefanangelovski/plunder

Web-scraper and frontend app for the Trimui Smart Pro on Crossmix-OS, letting you easily browse and access ROM sites directly from your handheld.
https://github.com/stefanangelovski/plunder

cpp crossmixos handheld roms scraper storefront trimui

Last synced: about 2 months ago
JSON representation

Web-scraper and frontend app for the Trimui Smart Pro on Crossmix-OS, letting you easily browse and access ROM sites directly from your handheld.

Awesome Lists containing this project

README

          

# BIG RELEASES COMING, MAJOR RELEASE v2.0.0 RELEASED WITH AUTO-UPDATING, SO EVERYONE USING 1.0.0 WILL HAVE TO MIGRATE IN ORDER TO RECEIVE UPDATES!!!
# ๐Ÿดโ€โ˜ ๏ธ Plunder

**A romsite scraper and frontend for the Trimui Smart Pro handheld.**

Plunder makes it easy to browse, search, and download games directly from your device.
It works on both the **stock Trimui OS** and **[CrossMix OS](https://github.com/cizia64/CrossMix-OS)**.

---

## ๐Ÿš€ Installation

1. Download the latest release from [Releases](https://github.com/StefanAngelovski/Plunder/releases).
2. Unzip the archive.
3. Place the **Plunder** folder into: /SDCARD/Apps/

4. Launch it from your Trimui Smart Pro app menu.

---

## ๐ŸŽฎ Usage

- **Browse & Scrape:** Explore several popular romsites.
- **Search & Filter:** Quickly find your favorite games with filtering.
- **Auto-mapped Consoles:** Scraped games are mapped directly to your deviceโ€™s folder structure.
- **Cache Management:** A single button clears the image cache for smoother performance.

๐Ÿ“ธ **Preview:**
UI Screenshot
๐ŸŽฅ **Preview:**

[**Watch the demo video**](https://github.com/user-attachments/assets/903e35f0-b2c2-46d3-8dd1-a1b69d0ae6be)

๐Ÿ–ผ๏ธ **App logo in Trimui menu:**
Logo

---

## โœจ Features

- Works with **stock OS** and **CrossMix OS**
- Modular scraper design โ†’ easily expandable to more romsites
- Regex-powered scraping (with planned improvements for readability)
- Filtering system for faster game discovery
- One-click **cache clearing** for optimization
- Direct console โ†” folder mapping
- Auto updating straight from Github releases

---

## ๐Ÿ”ฎ Roadmap / Known Issues

- [ ] Improve modularity of scrapers & reduce repeated logic
- [ ] Replace regex-based parsing with a cleaner library
- [ ] Fix missing images due to `SDL2_image` lacking WebP support in CrossMix
- [ ] Theming
- [ ] Switching to 7z for decompression, will allow for .rar decompression thus increasing compatibility
- [ ] Support for Knulli (as well as other devices)
- [ ] Global searching (search through all sources at the same time)
- [ ] Downloading multiple games at the same time asynchronously (with a download manager)
- [ ] Pausing downloads
- [ ] Downloading in background while gaming (if possible)
- [ ] More sources

---

## โš™๏ธ Developer Notes

Development of Plunder was made possible thanks to the excellent **[Trimui Smart Pro Docker Build System by Maxwell](https://github.com/Maxwell-SS/trimui-smart-pro-build-system)**.
Please consult his documentation if youโ€™d like to build Plunder from source.

---

## ๐Ÿด Credits

- **Main Developer:** [@StefanAngelovski](https://github.com/StefanAngelovski)
- **Build System:** [@Maxwell-SS](https://github.com/Maxwell-SS)