https://github.com/nbonamy/retropie_rom_browser
https://github.com/nbonamy/retropie_rom_browser
arcade emulationstation retropie rom roms
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/nbonamy/retropie_rom_browser
- Owner: nbonamy
- Created: 2021-01-30T22:07:59.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-02-07T21:27:59.000Z (about 4 years ago)
- Last Synced: 2025-01-13T20:27:35.154Z (4 months ago)
- Topics: arcade, emulationstation, retropie, rom, roms
- Language: PHP
- Homepage:
- Size: 472 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Retropie Rom Browser
A simple PHP based webapp allowing to browse your installed ROMS and:
- Search roms
- Delete roms
- Add or remove roms from your favorite
- Remove duplicates from your roms collection
## Setup
Your mileage may vary there but you need to have a HTTP server with PHP enabled. Instructions can be found [here](https://pimylifeup.com/raspberry-pi-lighttpd/) (provided as an example without warranty). On my setup, [Pi-hole](https://pi-hole.net/) was also installed so lighttpd and PHP came for "free".
Now git clone this repo in `/var/www` or `/var/www/html` depending on your setup. Instructions are given for `/var/www` ; add `/html` where needed in all commands.
```
sudo git clone https://github.com/nbonamy/retropie_rom_browser /var/www/roms
```
Then you need to run the following commands:
```
sudo ln -s $HOME/.emulationstation/downloaded_images /var/www/roms/covers
sudo find $HOME/.emulationstation/gamelists -name gamelist.xml -exec chmod o+w {} \;
```
The first command allows to view game covers in the browser. The second command allows to add roms as favorites.
Once done you should be able to access the URL: [http://\/roms](http://127.0.0.1/roms)
## Customization
If RetroPie/EmulationStation are not installed by `pi` user, you need to change the constants at the top of `romsite.php` file.
## Deduplication
Deduplication aims at removing duplicate roms for the same system (not across systems). It does by checking if multiple roms refer to the same game name and then uses a basic knowledge to determine which version to keep. Some examples of rules:
- Try to avoid bootleg and beta versions
- Use Revision/Set/... to try to keep latest version
- Choose versions from specific regions over others
The region prioritization is opiniated and you may want to change the score of each region in `romsite.php`. Try to keep a 20 point difference between each region to allow for revision numbers to have an impact.
Before roms are actually deleted, you will get a confirmation screen with a summary of the "decision" that was made for each game.