Data

Tools

Indexes

Applications

Experiments

Awesome

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

https://github.com/cosmo0/arcade-manager

Arcade management tool to handle your MAME/FBA romsets
https://github.com/cosmo0/arcade-manager

arcade arcade-management best-game emulation fba filter game mame recalbox retropie rom-management romset

Last synced: 5 days ago
JSON representation

Arcade management tool to handle your MAME/FBA romsets

Awesome Lists containing this project

README 

          
# Arcade manager for Retropie & Recalbox



[![ArcadeManager Windows](https://github.com/cosmo0/arcade-manager/actions/workflows/win.yml/badge.svg)](https://github.com/cosmo0/arcade-manager/actions/workflows/win.yml)

[![ArcadeManager Linux](https://github.com/cosmo0/arcade-manager/actions/workflows/linux.yml/badge.svg)](https://github.com/cosmo0/arcade-manager/actions/workflows/linux.yml)

[![ArcadeManager MacOS](https://github.com/cosmo0/arcade-manager/actions/workflows/mac.yml/badge.svg)](https://github.com/cosmo0/arcade-manager/actions/workflows/mac.yml)



[![Translation status](https://hosted.weblate.org/widget/arcademanager/arcademanager-ui/svg-badge.svg)](https://hosted.weblate.org/engage/arcademanager/)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=cosmo0_arcade-manager&metric=bugs)](https://sonarcloud.io/dashboard?id=cosmo0_arcade-manager)

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=cosmo0_arcade-manager&metric=code_smells)](https://sonarcloud.io/dashboard?id=cosmo0_arcade-manager)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=cosmo0_arcade-manager&metric=ncloc)](https://sonarcloud.io/dashboard?id=cosmo0_arcade-manager)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=cosmo0_arcade-manager&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=cosmo0_arcade-manager)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=cosmo0_arcade-manager&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=cosmo0_arcade-manager)



ArcadeManager is a rom management tool that will work with any arcade emulator romset. It helps you filter your arcade rom collection (MAME/FBNeo) by removing unwanted, bad, and unplayable games.



It also includes several selection of "best games", if you feel a bit lost among the several thousand games that full MAME romsets provide, and want a quick way to just keep the best ones.



It also installs overlays/bezels, but only Retropie and Recalbox are currently supported.



## Download



The latest version is available here: 



## Features



* User-friendly, easy to use interface with included extensive help

* Wizard with various pre-built lists of "best games"

* Manage rom files: copy or cleanup a selection of roms

* Checks and fixes a romset, and converts it to non-merged (other types are not supported)

* Download and install an overlays pack (Retropie or Recalbox)

* Manage games lists to use with the roms file management: merge and split files, convert DAT or INI files, and more



And also:



* Multi-platform, works on Windows, MacOS and Linux

* Multi-language (check "translating" if you want to help)



Copying files assumes you have a working romset corresponding to the MAME/FBNeo version you're using. ArcadeManager can convert a romset to non-merged (all clones can work on their own) but not to other types; for that, use a tool like [ClrMamePro](https://mamedev.emulab.it/clrmamepro/).



Obviously, this tool does not download roms.



## Screenshots



![Home](https://raw.githubusercontent.com/cosmo0/arcade-manager/docs/images/screen-home.png)

![Wizard](https://raw.githubusercontent.com/cosmo0/arcade-manager/docs/images/screen-wizard.png)

![Install overlays](https://raw.githubusercontent.com/cosmo0/arcade-manager/docs/images/screen-overlay-download.png)

![Download CSV](https://raw.githubusercontent.com/cosmo0/arcade-manager/docs/images/screen-csv-download.png)

![Copy roms](https://raw.githubusercontent.com/cosmo0/arcade-manager/docs/images/screen-rom-copy.png)



## External help



If you are new to arcade emulation, please read these resources:



* [Arcade roms and how to play them, a non-technical guide](https://retropie.org.uk/forum/topic/7247/)

* [Demistifying MAME roms](https://web.archive.org/web/20180101211010/https://choccyhobnob.com/mame/demystifying-mame-roms/)



## Translating



Anyone can help with translations: they're simple text files (INI style) located in `Data\translations`.



If you think you can help, please create a pull request! Or just send me the translated files. I'm happy either way.



If you want to test your translations, you'll have to add your language to `src\ArcadeManager.Core\Services\Localizer.cs` in the `_locales` array.



You can also contribute using [Weblate](https://hosted.weblate.org/projects/arcademanager/arcademanager-ui/).



## Development



### Prerequisites



* Dotnet 6 SDK - 

* Dotnet 8 SDK - 

* NodeJS 22.x or later - 

* Open a command line and run `dotnet tool install --global ElectronNET.CLI`



### Build and run



````bash

cd src/ArcadeManager

dotnet build

electronize start

````



To debug, attach Visual Studio to the `ArcadeManager` process.



Run `.\samples\generate-samples.ps1` in Powershell to generate a fake romset in `tmp\roms` (empty zip files with the right names).



### Create an install package



Choose your OS and architecture:



````bash

electronize build /target win

electronize build /target osx /electron-arch arm64

electronize build /target linux

````



Windows ARM and Linux ARM are not currently supported.  

MacOS x86 is not supported anymore.



If you want to build for another architecture, edit the file `src\ArcadeManager\electron.manifest.json`, scroll down to "build", locate your platform (win, osx, linux), and in "target", change the "arch" property to your architecture (x64 or arm64). Don't forget to build using the matching `/electron-arch` parameter.