{"id":16530939,"url":"https://github.com/nbonamy/retropie_rom_browser","last_synced_at":"2026-05-15T05:03:04.831Z","repository":{"id":147095789,"uuid":"334521526","full_name":"nbonamy/retropie_rom_browser","owner":"nbonamy","description":null,"archived":false,"fork":false,"pushed_at":"2021-02-07T21:27:59.000Z","size":483,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-13T20:27:35.154Z","etag":null,"topics":["arcade","emulationstation","retropie","rom","roms"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nbonamy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-30T22:07:59.000Z","updated_at":"2023-09-08T18:17:58.000Z","dependencies_parsed_at":"2023-05-10T18:30:29.564Z","dependency_job_id":null,"html_url":"https://github.com/nbonamy/retropie_rom_browser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbonamy%2Fretropie_rom_browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbonamy%2Fretropie_rom_browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbonamy%2Fretropie_rom_browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nbonamy%2Fretropie_rom_browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nbonamy","download_url":"https://codeload.github.com/nbonamy/retropie_rom_browser/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241637287,"owners_count":19994946,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arcade","emulationstation","retropie","rom","roms"],"created_at":"2024-10-11T18:07:32.484Z","updated_at":"2026-05-15T05:02:59.787Z","avatar_url":"https://github.com/nbonamy.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Retropie Rom Browser\n\nA simple PHP based webapp allowing to browse your installed ROMS and:\n- Search roms\n- Delete roms\n- Add or remove roms from your favorite\n- Remove duplicates from your roms collection\n\n\u0026nbsp;\n![preview](preview.jpg)\n\u0026nbsp;\n\n## Setup\n\nYour 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\".\n\nNow 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.\n```\nsudo git clone https://github.com/nbonamy/retropie_rom_browser /var/www/roms\n```\n\nThen you need to run the following commands:\n```\nsudo ln -s $HOME/.emulationstation/downloaded_images /var/www/roms/covers\nsudo find $HOME/.emulationstation/gamelists -name gamelist.xml -exec chmod o+w {} \\;\n```\n\nThe first command allows to view game covers in the browser. The second command allows to add roms as favorites.\n\nOnce done you should be able to access the URL: [http://\\\u003craspeberry pi ip\\\u003e/roms](http://127.0.0.1/roms)\n\n## Customization\n\nIf RetroPie/EmulationStation are not installed by `pi` user, you need to change the constants at the top of `romsite.php` file.\n\n## Deduplication\n\nDeduplication 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:\n- Try to avoid bootleg and beta versions\n- Use Revision/Set/... to try to keep latest version\n- Choose versions from specific regions over others\n\nThe 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.\n\nBefore roms are actually deleted, you will get a confirmation screen with a summary of the \"decision\" that was made for each game.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnbonamy%2Fretropie_rom_browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnbonamy%2Fretropie_rom_browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnbonamy%2Fretropie_rom_browser/lists"}