RetroArch terminology and troubleshooting / 2026-08-02

RetroArch core info file vs core binary on Android

Understand why a core can exist but show incomplete metadata, or appear in a menu but still fail to load.

8 minute terminology guideCurrent RetroArch for Android; available update actions vary by distribution

RetroArch core info file vs core binary on Android

The core binary executes emulation; its `.info` record supplies frontend metadata such as name, systems, extensions, firmware notes, and database associations. Updating Core Info Files cannot install or repair a missing or incompatible core binary, while replacing a binary does not guarantee matching metadata.

Do this in order

  1. 01

    Record the RetroArch package/version and the core name shown under Information.

  2. 02

    Check whether Load Core can select the binary and whether Information shows a library name and version.

  3. 03

    Inspect the configured Core and Core Info directories without assuming shared-storage paths.

  4. 04

    Use Update Core Info Files only if the distribution documents and exposes it.

  5. 05

    Restart RetroArch, select the core, and test one authorized known-good item directly.

  6. 06

    If loading fails, collect the log and verify CPU architecture, binary source and package boundary.

Decision and diagnostic table

ObjectPurposeA missing object causes
Core binaryRuns emulator codeNo execution or load failure
Core info fileDescribes capabilities/metadataMissing labels, extensions or firmware notes
DatabaseRecognizes content for playlistsScan omission
Core backupVersion rollback copyNo automatic compatibility proof

Metadata is not executable code

A polished core entry can still point to an incompatible binary, and an executable core can be hard to discover when its info record is absent.

Distribution policy controls updates

Some Android packages expose online updating and others ship cores through the package. Follow the official distribution's mechanism rather than mixing binaries from unknown sources.

First-party sources

Related guides