Retroarch bezels / overlays tool
Overlays (or bezels) are images added “above” the emulator, to mask the black borders around the image.
This tool provides several utilities:
- convert MAME bezels to Retroarch overlays, so they can be used with any Libretro emulator
- convert Retroarch overlays to MAME bezels
- check Retroarch overlays integrity
It works under Windows x64/ARM64, Linux x64/ARM64 and MacOS x64. You can build it for any platform supported by .Net 5 (it’s very easy).
Download
Download the latest release
Usage
!!! BACKUP YOUR FILES BEFORE USING THIS TOOL !!! I have used it on my own files but I cannot guarantee that it will work on yours.
Get a detailed help and list of options by running bezel-tools --help or bezel-tools [verb] --help.
Check overlays integrity
Simple check:
bezel-tools check –overlays-config samples/retroarch/overlays –roms-config samples/retroarch/roms
Check and fix when possible:
bezel-tools check –overlays-config samples/retroarch/overlays –roms-config samples/retroarch/roms –autofix –input-overlay-path /opt/retropie/configs/all/retroarch/overlay/ –template-overlay templates/overlay.cfg –template-rom templates/game.cfg
Convert MAME bezels to RetroArch overlays
bezel-tools mtr –source path/to/mame/zips –output-roms output/roms –output-overlays output/overlay –template-game templates/game.cfg –template-overlay templates/overlay.cfg
Convert RetroArch overlays to MAME bezels
bezel-tools rtm –source-roms path/to/rom/files –source-configs path/to/config/files –output path/to/output –template templates/default.lay –zip
