Skip to main content

Add Your Own ROM

If you have a ROM file that isn't in the built-in catalog — a legally owned title, a homebrew game, a translation patch, etc. — you can import it through the Add Game flow.

How to import​

  1. Go to Collection → tap Add Games (or tap Add Game on the Discover tab).
  2. The Add Games screen opens with a list of supported file types.
  3. Tap Select File. Android's system file picker (Storage Access Framework) opens.
  4. Navigate to your ROM file and select it.
  5. Fill in the game info form: name, system, category, description, year, manufacturer, etc.
  6. Save. The game now appears in your library and is immediately playable.

TODO: Add Game form

Supported file types​

Different systems accept different file extensions:

SystemTypical extensions
DOS / Windows.zip (preferred), .exe, .bat inside a .zip
Arcade / MAME.zip (CHD inside ZIP for big games)
NES / SNES / GB / GBC / GBA.nes, .smc / .sfc, .gb, .gbc, .gba
Mega Drive / Genesis.md, .bin, .smd
PSX.cue + .bin, .chd, .pbp
PSP.iso, .cso
NDS.nds
3DS.3ds, .cia
Sega Saturn.cue + .bin, .chd
Amiga.adf, .ipf inside .zip
C64.d64, .t64, .prg
MSX.rom, .dsk
PC-98.hdi, .fdi, .d88
tip

For multi-file games (e.g. .cue + .bin), pack them into a single .zip or .chd first when possible. SAF works best on a single file per import.

Required vs optional fields​

When you import a ROM, the form asks for several fields. You must fill in:

  • Name
  • System (the emulator core depends on this)
  • File (the import target)

Optional fields like manufacturer, year, category, language, description, and cover image improve how the game shows in Discover/Explore/Search but don't affect playability.

BIOS files​

A few cores need a BIOS file in addition to the ROM:

  • Sega Saturn needs its region BIOS (and Genesis can use Sega CD BIOS files for CD-based content)
  • PSP needs nothing extra (PPSSPP includes what's required)

If a BIOS is missing, the app shows an error on launch. You can add a BIOS via the same Add Game flow — pick the BIOS file and choose BIOS as the type.

Editing an imported game​

You can edit any field after the fact: open the game's Game Detail page → tap the ⋮ menu → Edit Info. Useful for fixing typos in the name or assigning a better cover.

Deleting an imported game​

From the game's detail page, tap ⋮ menu → Delete ROM. The ROM file is removed from device storage and the entry from your library.