Guide

ZyperOS Systems, Game Folders and File Types

By Tarik Caramanico · · Updated · 4 min read

ZyperOS 1.0.5 supports 45 systems and a separate Ports shelf. This reference lists every game folder, accepted file type and emulator. Use it when you add games or a game does not appear.

On this page
  1. Use the right folder
  2. Full system table
  3. Keep discs and their tracks together
  4. Arcade sets and special formats
  5. Doom games and mods
  6. Use folders from another system

These steps cover ZyperOS 1.0.5. Check your version in MENU > About.

Use the right folder

  1. Open the ZYPEROS drive on your card, or open ZyperOS's File Transfer page.
  2. Find your system in the table below.
  3. Copy the game into that system's folder under Roms/.
  4. Check that its file type matches the table.
  5. Add any required files from the BIOS guide.

The adding games guide explains card readers, USB and Wi-Fi transfers. An empty system stays hidden on the home screen.

Full system table

Folder names appear exactly as ZyperOS uses them. On a narrow screen, scroll the table sideways to see the file types and emulator.

SystemGame folderFile typesEmulator
32XRoms/32X.32x .zipPicoDrive
3DORoms/3DO.iso .chd .cueOpera
ArcadeRoms/Arcade.zip .7zFinalBurn Neo
Atari 2600Roms/Atari 2600.a26 .bin .zipStella 2014
Atari 5200Roms/Atari 5200.a52 .bin .zipa5200
Atari 7800Roms/Atari 7800.a78 .bin .zipProSystem
Atari LynxRoms/Atari Lynx.lnx .o .zipHandy
AtomiswaveRoms/Atomiswave.zip .7zflycast2021
ColecoVisionRoms/ColecoVision.col .cv .bin .rom .zipGearcoleco
DoomRoms/Doom.wad .iwad .pwad .m3uPrBoom
DreamcastRoms/Dreamcast.chd .cdi .gdi .cueflycast2021, or Flycast if you add it
Game & WatchRoms/Game & Watch.mgwGame & Watch
Game BoyRoms/Game Boy.gb .dmg .zipmGBA
Game Boy AdvanceRoms/Game Boy Advance.gba .agb .zipmGBA
Game Boy ColorRoms/Game Boy Color.gbc .cgb .zipmGBA
Game GearRoms/Game Gear.gg .zipGenesis Plus GX
GenesisRoms/Genesis.md .gen .bin .smd .zipGenesis Plus GX
J2MERoms/J2ME.jar .kjxFreeJ2ME-Plus
MAMERoms/MAME.zipMAME 2003-Plus
Master SystemRoms/Master System.sms .zipGenesis Plus GX
MSX2Roms/MSX2.rom .mx1 .mx2 .dsk .cas .zipblueMSX
NAOMIRoms/NAOMI.zip .7zflycast2021
Neo GeoRoms/Neo Geo.zip .7zFinalBurn Neo
Neo Geo CDRoms/Neo Geo CD.chd .cueNeoCD
Neo Geo PocketRoms/Neo Geo Pocket.ngp .ngc .ngpc .npc .zipBeetle NeoPop
Neo Geo Pocket ColorRoms/Neo Geo Pocket Color.ngp .ngc .ngpc .npc .zipBeetle NeoPop
NESRoms/NES.nes .fds .unf .unif .zipFCEUmm
Nintendo 64Roms/Nintendo 64.n64 .z64 .v64 .zipParallelN64, or Mupen64Plus-Next
Nintendo DSRoms/Nintendo DS.nds .zipDSperate
OpenBORRoms/OpenBOR.pakOpenBOR
PICO-8Roms/PICO-8.p8 .pngFAKE-08
PlayStationRoms/PlayStation.cue .chd .pbp .m3u .ccd .toc .iso .mdf .cbn .exePCSX ReARMed
Pokémon MiniRoms/Pokemon Mini.min .zipPokeMini
PortsRoms/Ports.sh, with the port's folder beside itPortMaster
PSPRoms/PSP.iso .cso .chd .pbpPPSSPP
SaturnRoms/Saturn.cue .chd .iso .ccd .mdsYabaSanshiro
ScummVMRoms/ScummVMa folder per gameScummVM
Sega CDRoms/Sega CD.chd .cue .iso .m3uPicoDrive
SG-1000Roms/SG-1000.sg .zipGenesis Plus GX
SNESRoms/SNES.sfc .smc .zipSnes9x 2010
TIC-80Roms/TIC-80.tic .pngTIC-80
TurboGrafx-16 and CDRoms/TurboGrafx-16.pce .sgx .cue .ccd .chd .toc .m3u .zipBeetle PCE Fast
VectrexRoms/Vectrex.vec .bin .zipvecx
Virtual BoyRoms/Virtual Boy.vb .vboy .zipBeetle VB
WonderSwanRoms/WonderSwan.ws .wsc .zipBeetle WonderSwan
WonderSwan ColorRoms/WonderSwan Color.ws .wsc .zipBeetle WonderSwan

The Nintendo 64 shelf offers two included cores. Dreamcast uses flycast2021 by default; standalone Flycast requires a separate installation. A listed system does not promise full speed for every game.

Keep discs and their tracks together

A .cue or .gdi file describes a disc and its tracks. Copy its track files too, in the same relative locations. A PlayStation .bin by itself does not appear as a separate game.

For a multi-disc PlayStation game, make one folder for the game. Put its discs and an .m3u playlist inside. List one disc file per line, with names that match the files:

Disc 1.chd
Disc 2.chd

The shelf treats that folder as one game. For ordinary collections, you can also create folders within a system, such as Roms/Game Boy Advance/Translations/.

Arcade sets and special formats

  • Arcade and Neo Geo: use FinalBurn Neo sets. Keep each archive whole and keep its original name. Neo Geo also needs neogeo.zip in Bios/ or beside the game.
  • MAME: use sets for MAME 2003-Plus. These differ from the FinalBurn Neo sets used by Arcade.
  • ScummVM: copy one folder per game into Roms/ScummVM. An optional .scummvm file inside it contains the ScummVM game ID when automatic detection is unclear.
  • OpenBOR: copy a packed .pak module. An unpacked game folder needs packing first.
  • PICO-8: use .p8 files or .p8.png cart images. Ordinary pictures are not carts.
  • TIC-80: use .tic files or PNG cart images. Its saved game data works, but its core has no save states.
  • PSP: use one of the four file types in the table. PPSSPP needs no separate BIOS. Its game saves use Saves/PSP/SAVEDATA.
  • Ports: the .sh launcher goes directly in Roms/Ports, with the port's data folder beside it. Follow the PortMaster guide for installation.

Doom games and mods

An IWAD contains a complete game. Put it in Roms/Doom. A PWAD contains a mod and needs its base IWAD beside it.

To choose a specific IWAD or load several mods, create an .m3u file. Put the IWAD first, then one mod per line:

doom2.wad
my-mod.wad

Without a playlist, PrBoom uses an IWAD from the same folder and prefers Doom II. Save states work inside a level.

Use folders from another system

ZyperOS also accepts EmulationStation folder names, such as gba, nds, psx and megadrive. Copy those system folders into Roms/.

Each system reads one folder. ZyperOS uses its normal folder when that folder contains a game. Otherwise, it uses the accepted alternate folder with the most games. It does not combine both folders into one shelf.

Put games for one system together if you want them on one shelf. The missing games checks cover rescanning and file types.

Folder names and file types follow the ZyperOS 1.0.5 system configuration. Emulator names and special format notes follow its user documentation.