v4.1

What's Changed

• Fixes issue #7 : debug ouptput was broken

Full Changelog: v4.0...v4.1

MAME / Retroarch bezel / overlays tool v4.0

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
• generate Retroarch overlays from images

It works under Windows, Linux and MacOS. A GUI is provided for Windows.

New features

There is now a GUI for Windows, so you don't have to learn arcade scripting to fix your visual stuff.

MAME / Retroarch bezel / overlays tool

Changes

Fixes issue #1 : while converting a MAME .lay file, does not assume the first found <bezel> is the right one.

MAME / Retroarch bezel / overlays tool

Changes

Fixes two bugs during MAME to Retroarch conversion when the bezel was resized: when scanning for the screen coordinate, and when converting coordinates.

MAME / Retroarch bezel / overlays tool

Changes

• Fixes a few bugs when files are missing or badly formed

Retroarch / MAME bezel / 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
• generate Retroarch overlays from images

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 list of possible actions using bezel-tools --help.
Get a detailed list of options for each action using bezel-tools [verb] --help.

Check overlays integrity

Checks that:

• the rom config points to an existing overlay
• the overlay config points to an existing image
• all images in the overlays folder have an associated overlay config and rom config, and can create one
• all overlay configs are used by a rom config, and can create one
• the path written in the config matches the expected one (to check overlays that will be used on another machine)
• the image has a size matching the output resolution
• the coordinates of the game in the rom config match the transparency in the image

It assumes that rom config are named xxxx.zip.cfg, and images are stored in the same folder as the overlay config.

Simple check:

bezel-tools check --overlays-config samples/retroarch/overlays --roms-config samples/retroarch/roms --output-debug debug/

• --overlay-config is the path where the overlays are (cfg files and images)
• --roms-config is the path to the cfg files for the roms
• --output-debug is the path to the debug images, to see what will be computed

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

• --overlay-config is the path where the overlays are (cfg files and images)
• --roms-config is the path to the cfg files for the roms
• --autofix fixes encountered problems
• --input-overlay-path is the expected path to the overlay in the rom config (ex: /opt/retropie/configs/all/retroarch/overlay/ for a Retropie overlay)
• --template-overlay is the path to the overlay template
• --template-rom is the path to the rom template

Generate overlays from images

Generates overlay and rom configs based on the position of the screen transparent area, and the file name.

bezel-tools generate --images samples/images --roms-configs samples/roms --template-overlay templates/overlay.cfg --template-rom templates/game.cfg

• --images is the path to the images folder (the overlay configs will be generated inside)
• --roms-configs is the path to the rom configs folder
• --template-overlay is the path to the overlay template
• --template-rom is the path to the rom template

Convert MAME bezels to RetroArch overlays

Scans a folder containing MAME bezel files (it can scan zip files), and converts the content to a Retroarch overlay.

It can also read apply offsets stored in MAME configs.

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

• --source is the path where you store your zip files containing your MAME bezels
• --output-overlays is where the png and overlay cfg files will be created
• --output-roms is where rom cfg files will be created (where the screen dimensions are stored)
• --template-game is a template rom cfg that will be modified (a sample is provided)
• --template-overlay is a template overlay cfg that will be modified (a sample is provided)
• --overwrite to overwrite existing files

Convert RetroArch overlays to MAME bezels

Scans a folder containing Retroarch overlays and converts them 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

• --source-roms is the path to the rom cfg (the .zip.cfg files)
• --source-configs is the path to the folder where the cfg files are located
• --output is where the MAME bezels will be created
• --template is the template for the lay file that will be modified (a sample is provided)
• --zip zips the result (otherwise it just creates a folder)
• --overwrite to overwrite existing files

Common parameters for all actions

• --error-file path/to/file.csv the path to the output CSV file containing the errors and fixes
• --output-debug path/to/debug to see the result of the conversion (it creates an image with a red square where the screen will be)
• --margin 10 to add or remove a 10px margin to the screen position (positive value to crop a bit of the screen)
• --threads 4 to use 4 threads

Retroarch bezels / overlays tool

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).

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

MAME & Retroarch bezel & overlay converter

MAME / Retroarch bezels and overlays converter

Overlays (or bezels) are images added "above" the emulator, to mask the black borders around the image.

This tool converts MAME bezels to Retroarch overlays, so they can be used with any Libretro emulator.

It works under Windows x64/ARM64, Linux x64/ARM64 and MacOS x64.

Usage

Get a detailed help by running mame-bezel-converter --help.

Convert MAME bezels to RetroArch overlays

mame-bezel-converter.exe mtr --source path/to/mame/zips --output-roms output/roms --output-overlays output/overlay --template-game templates/game.cfg --template-overlay templates/overlay.cfg

• --source is the path where you store your zip files containing your MAME bezels
• --output-overlays is where the png and overlay cfg files will be created
• --output-roms is where rom cfg files will be created (where the screen dimensions are stored)
• --template-game is a template rom cfg that will be modified (a sample is provided)
• --template-overlay is a template overlay cfg that will be modified (a sample is provided)

Convert RetroArch overlays to MAME bezels

mame-bezel-converter.exe rtm --source-roms path/to/rom/files --source-configs path/to/config/files --output path/to/output --template templates/default.lay --zip

• --source-roms is the path to the rom cfg (the .zip.cfg files)
• --source-configs is the path to the folder where the cfg files are located
• --output is where the MAME bezels will be created
• --template is the template for the lay file that will be modified (a sample is provided)
• --zip zips the result (otherwise it just creates a folder)

Common parameters

• --overwrite to overwrite existing files
• --scan-bezel to scan transparent pixels in the images instead of relying on the cfg/lay files
• --output-debug path/to/debug to see the result of the conversion (it creates an image with a red square where the screen will be)
• --margin 10 to add or remove a 10px margin (positive value to crop a bit of the screen)
• --threads 4 to use 4 threads

MAME & Retroarch bezel & overlay converter

First release

Features :

• Converts MAME bezels to Retroarch overlays
• Converts Retroarch overlays to MAME bezels