Skip to content

BATOCERA-SETUP.md

Latest commit

 

History

History
88 lines (60 loc) · 2.64 KB

BATOCERA-SETUP.md

File metadata and controls

88 lines (60 loc) · 2.64 KB

DMINLauncher - Batocera Setup Guide

Installation

  1. Copy DMINLauncher to Ports folder:

    /userdata/roms/ports/DMINLauncher-linux-x64

  2. Make executable:

    chmod +x /userdata/roms/ports/DMINLauncher-linux-x64

  3. Configuration:

The launcher automatically creates a dminlauncher.cfg file with default Batocera paths on first run. No manual configuration needed!

Default Paths

WAD Files

Place your WAD files in:

/userdata/roms/gzdoom/

Engine Detection

Batocera includes GZDoom at /usr/bin/gzdoom

The launcher will automatically detect it as "gzdoom (system)" - you don't need to set the engine directory to /usr/bin.

Creating an entry in the Ports folder

Note: evmapy should be ended as shown in the script example. Batocera hotkeys are currently not supported. You will have to use a keyboard and press escape to first access the doom port menu. Then in the controls settings you can map your start button to show the menu, as well as your other game controller settings.

Create a file: /userdata/roms/ports/DMINLauncher.sh

#!/bin/bash

cd /userdata/roms/ports
killall evmapy
./DMINLauncher-linux-x64

Then make it executable:

chmod +x /userdata/roms/ports/DMINLauncher.sh

Creating .gzdoom Game Configurations

NEW in v1.0.1+: DMINLauncher can now save Batocera-compatible .gzdoom configuration files!

When running on Batocera, a special "💾 Save Batocera .gzdoom Config" button appears at the bottom of the launcher. This allows you to:

  1. Configure your game/mod setup in DMINLauncher (select IWAD, mods, difficulty, etc.)
  2. Click the "Save Batocera .gzdoom Config" button
  3. Give it a name (e.g., "Brutal Doom.gzdoom")
  4. The file is saved to /userdata/roms/gzdoom/
  5. Your game will now appear in EmulationStation as a selectable entry!

What Gets Saved

The .gzdoom file contains all your settings in the format Batocera expects:

  • Base IWAD (-iwad DOOM2.WAD)
  • All mods in load order (-file mod1.pk3 mod2.wad)
  • Difficulty level (-skill 3)
  • Starting map (-warp 5)
  • DMFLAGS for multiplayer/gameplay options
  • Run switches (fast monsters, no monsters, turbo, etc.)
  • Hexen class selection (if playing Hexen)

Example .gzdoom File

-iwad DOOM2.WAD -file brutalv21.pk3 maps_of_chaos.wad -skill 4 -fast

This single-line format is exactly what Batocera's GZDoom system requires. The filename (without extension) becomes the game name in EmulationStation.

Troubleshooting

App doesn't start

  1. Check execute permissions: chmod +x DMINLauncher-linux-x64
  2. Run from terminal to see errors: ./DMINLauncher-linux-x64