MAME configuration terminology and diagnosis / 2026-08-08

MAME readconfig and noreadconfig explained for Android troubleshooting

Use the configuration-loading switch as a clean diagnostic boundary without deleting INI files or confusing wrapper defaults with MAME defaults.

7 minute diagnosisOfficial MAME 0.289 semantics; Android wrapper arguments remain a separate layer

MAME readconfig and noreadconfig explained for Android troubleshooting

`readconfig` allows MAME to load its normal configuration files; `noreadconfig` starts without reading them. Use `-noreadconfig` for one controlled launch to ask whether an INI-layer setting causes the failure, then compare showconfig output. Do not delete configuration files or assume the Android wrapper stopped injecting arguments.

Do this in order

  1. 01

    Record the wrapper settings and capture the normal effective configuration.

  2. 02

    Back up INI and CFG directories without moving or editing them.

  3. 03

    Launch the same authorized machine once with `-noreadconfig` and otherwise identical arguments.

  4. 04

    Compare the first error, paths, renderer, sound, and input behavior with the normal launch.

  5. 05

    If the failure disappears, re-enable configuration and inspect precedence one file at a time.

  6. 06

    If it remains, move to wrapper arguments, content audit, or platform logs; restore no files because none were deleted.

Decision and diagnostic table

ResultMeaningNext boundary
Only normal launch failsLoaded configuration contributesInspect INI precedence
Both launches fail identicallyCause is outside loaded INIWrapper, media, OS log
Paths differINI supplies search pathsCompare showconfig
Option unavailableWrapper filters upstream switchUse package diagnostics

A clean launch is an experiment

`-noreadconfig` changes one input layer and preserves the original files. That makes it safer and more informative than resetting an entire app.

Wrapper arguments can still win

An Android frontend can append command-line values even when MAME skips INI files. Record those arguments before attributing the result to upstream defaults.

First-party sources

Related guides