No description
Find a file
2026-02-26 21:16:56 +01:00
.forgejo/workflows Update forgejo to make an appimage 2026-02-26 21:16:56 +01:00
build Update forgejo to make an appimage 2026-02-26 21:16:56 +01:00
docs Updated readmes, multi-language 2026-02-26 21:02:45 +01:00
stub 2.0 2024-07-14 15:24:41 +02:00
tool add 40S beta link to pandora3dplus 2026-01-24 12:26:47 +01:00
.clang-format 2.0 2024-07-14 15:24:41 +02:00
.gitignore 2.0 2024-07-14 15:24:41 +02:00
.gitlab-ci.yml 2.0 2024-07-14 15:24:41 +02:00
HISTORY.md history / readme updates 2020-06-13 18:09:56 +09:00
LICENSE 2.0 2024-07-14 15:24:41 +02:00
meson.build Version bump & remove dead usage from UserFolders 2025-06-08 14:15:41 +02:00
README-cy.md remove stray rule 2026-02-26 21:09:29 +01:00
README-de.md remove stray rule 2026-02-26 21:09:29 +01:00
README-es.md remove stray rule 2026-02-26 21:09:29 +01:00
README-fr.md remove stray rule 2026-02-26 21:09:29 +01:00
README-it.md remove stray rule 2026-02-26 21:09:29 +01:00
README-ja.md remove stray rule 2026-02-26 21:09:29 +01:00
README-pt.md remove stray rule 2026-02-26 21:09:29 +01:00
README-ru.md remove stray rule 2026-02-26 21:09:29 +01:00
README-zh.md remove stray rule 2026-02-26 21:09:29 +01:00
README.md remove stray rule 2026-02-26 21:09:29 +01:00

PandoryTool for Pandora Box Arcade Systems

PandoryTool overview

PandoryTool is a Swissarmyknife for your Pandora Game system. It installs games, jailbreaks, and activates improvements that fix factory misconfigurations across a wide range of models.


Download PandoryTool for Windows

PandoryTool is available for Windows from https://teampandory.itch.io/pandorytool.


PandoryTool is compatible with several variants of Pandora, including the following:

Pandora Box DX - "PandoryDX"

Jump to the feature overview: PandoryDX Features

  • Pandora Box DX 3000 (versions 1.0, 1.1, 1.2, 1.3)
  • Pandora Box DX “Special” 5000 (versions 1.3, 1.4)
  • Pandora Saga DX (3000 and 5000 versions with the green heatsink on the motherboard)
  • Pandora Box King of Air 2 and DualBoot DXVertical (versions 1.2, 1.3, 1.4)
  • Note: Some variants ship with 20000+ games. They work, but you cannot add games.

Pandora Games 3D - "Pandory3D"

Jump to the feature overview: Pandory3D Features

  • Pandora Games 3D — 2448 / 4018 Games, blue GB3000 motherboard, firmware 20191017 or 20200217
  • Pandora Games 3D+ — 4018 Games, blue GB3000 motherboard, firmware 20200704 or 20200811
  • Pandora EX2 — green dual motherboards, firmware 20190826, 20210101, 20210303, 20230101, 20230303
  • Pandora Games 3D+ — 7000 Games, blue S905 motherboard, firmware 20201225
  • Pandora Saga 3D — 2650/4188 Games, green S812-00* motherboard, firmware 20190826
  • Pandora Saga 18S — 8000 Games, green S812-00* motherboard, firmware 20190826
  • GoldenSky G6
  • Pandora 3D RRTV 12S
  • Pandora 9H
  • NOT COMPATIBLE WITH 3D+ 40S VARIANT YET — COMING SOON!
  • Note: Some EX2 models cannot start the jailbreak installation. Results vary.
  • Note: Some models only support adding games and cannot currently be jailbroken.

Pandora Box Key 7 - "Pandory Seven"

PandorySeven is a small improvement pack for Pandora Key 7. It focuses on image clarity and classic 4:3 presentation, giving the Key 7 a cleaner, sharper look without modifying firmware.


PandoryTool Downloads for Other Operating Systems

Flatpak (Linux)

Add the PandoryTool remote and install:

flatpak remote-add --if-not-exists pandorytool https://teampandory.com/flatpak/index.flatpakrepo
flatpak install pandorytool com.teampandory.pandorytool

Run it from a terminal:

flatpak run com.teampandory.pandorytool

Usage Examples

1) Backup a 3D model (internal storage) with a backup stick

  1. Create the backup USB stick:
    pandory stick backup <destDrive>
    
    Example: pandory stick backup F:\
  2. When prompted, select the matching 3D/3D+ variant.
  3. Tutorial videos: Pandora MicroSD backup https://www.youtube.com/watch?v=sOluaeOtTX4, Full system backups https://www.youtube.com/watch?v=HdLaEymH0ok

2) Installing the Pandory3D improvements (jailbreak 3D models)

  1. Create the jailbreak USB stick:
    pandory stick jailbreak <destDrive>
    
    Example: pandory stick jailbreak F:\
  2. When prompted, choose [1] for Pandora Games 3D / Saga 3D (up to 20200217 firmware) or [2] for Pandora Games 3D+ (20200704 and later).
  3. Tutorial video: Jailbreak Pandora Games 3D / 3D+ / EX2 https://www.youtube.com/watch?v=cWdxBeuhXKU

3) Add games for 3D models

  1. Prepare ROMs for your device:
    pandory add <sourceDir> <destDir>
    
    Example: pandory add C:\roms F:\
  2. Tutorial video: Add games to Pandora Games 3D / 3D+ / EX2 https://www.youtube.com/watch?v=L_SA9xyiG9g

4) Perform the PSPFix for 3D models

  1. Prepare a clean exFAT USB stick and note its drive letter (example F:\).
  2. Create the Stage 1 installer on that USB stick:
    pandory pspfix stage1 <destDrive>
    
    Example: pandory pspfix stage1 F:\
  3. Safely eject the USB stick, boot the Pandora with its normal microSD, and insert the stick once to install the PSP injector.
  4. Power off, remove the Pandora microSD, insert it into your PC, and note its drive letter (example G:\).
  5. Apply Stage 2 directly to that microSD:
    pandory pspfix stage2 <destDrive>
    
    Example: pandory pspfix stage2 G:\
  6. Safely eject the microSD and put it back in the Pandora.
  7. Tutorial video: https://www.youtube.com/watch?v=_V6lSL9VPzI

5) Installing the PandoryDX improvements (DX models)

  1. Apply DX improvements to your DX microSD/USB:
    pandory stick dx <destDrive>
    
    Example: pandory stick dx F:\
  2. Tutorial video: Install PandoryDX for Pandora Box DX / King of Air 2 https://www.youtube.com/watch?v=yOsBYnR4bzg

6) Jailbreak a Pandora Key 7

  1. Create the jailbreak stick:
    pandory stick jailbreak <destDrive>
    
  2. When prompted, choose [3] - Pandora Key 7 (requires a microSD card; will not work on USB stick).

PandoryDX Features

PandoryDX is a friendly set of improvements for the DX range of Pandora Box arcade boards. It fixes factory misconfigurations without flashing firmware, and runs entirely from microSD or USB so you can remove it anytime.

PandoryDX overview

Skins

PandoryDX adds a new skin, removes the menu “click” sound, and lets you swap Pandora DX logos and graphics.

PandoryDX skins

4:3 Aspect Ratio Correction

Classic arcade games were designed for 4:3. The DX stretches to widescreen by default, but PandoryDX corrects this automatically.

PandoryDX 4:3 correction

Advanced users: You can override aspect ratio globally or pergame using forceHeight in pandory.xml on your microSD/USB.

Sharp Pixels / Blur Removal

DX boards scale lowres games up and add blur. PandoryDX removes the blur and can apply optional integer scaling for crisp pixels.

PandoryDX sharp pixels

Advanced users: Blur can be reenabled in pandory.xml for lowresolution arcade monitors.

Final Burn Alpha Core Clock Boost

Final Burn Alpha simulates original slowdown (e.g., Metal Slug 2). PandoryDX can overclock the emulated CPU for smoother play.

FBA core clock boost

Advanced users: Disable this in pandory.xml if you want original slowdown behavior.

Dipswitches

Hold START ingame to open the dipswitch menu (when supported) and tweak settings like difficulty or censorship.

Dipswitch menu

Smoother Scrolling

PandoryDX optimizes graphics settings for smoother scrolling, especially over HDMI.

Smoother scrolling

Character Unlocks

Some stock games hide characters. PandoryDX includes presets that unlock them by default.

Character unlocks

Buttons Reconfigured

PandoryDX fixes misconfigured controls and lets you define custom remaps in pandory.xml.

Buttons reconfigured

King of Air 2 Aspect Ratio Correction

The KOA2 vertical variant can display vertical games at the wrong width. PandoryDX corrects this.

King of Air 2 aspect correction

Attract-Mode

DX autoinserts coins in freeplay, which hides attractmode demos. PandoryDX disables autocoin for a more authentic arcade feel.

Attract mode

Advanced users: You can disable this in pandory.xml.

Improved Scanlines

Factory scanlines are thick and ugly. PandoryDX uses a lowCPU “JPINORoyale” scanline preset.

Improved scanlines

Advanced users: Scanline graphics and opacity are configurable in pandory.xml.

King of Air 2: HD Filter Disabled

KOA2 forces an HD filter that makes pixels look like an oil painting. PandoryDX disables it so pixels look correct again.

KOA2 HD filter disabled

Advanced users: You can reenable the filter in settings if you want.

Extra Emulators

DX ships with a small emulator set. PandoryDX adds extra emulators and lets you add games for these systems in roms_pandory on your microSD/USB.

Note: Some systems (e.g., Amiga) require Kickstart/BIOS files you provide.

Extra emulators Atari ST Extra emulators Amiga 500 Extra emulators Amiga 1200 Extra emulators Game Boy Extra emulators image 5 Extra emulators image 6 Extra emulators image 7 Extra emulators PC-Engine Extra emulators PC-Engine 2 Extra emulators Sega 32X

TATE Mode

PandoryDX can autorotate vertical games or let you rotate manually to fit a vertical screen.

TATE mode

Advanced users: Enable this in pandory.xml and use it for horizontal games on vertical screens if needed.

Custom Cores

Some games launch with suboptimal emulators out of the box. PandoryDX can autoswitch ROMs to better cores for performance or controls.

Custom cores

Advanced users: Example swaps like Final Burn Alpha to MAME2003 are set in pandory.xml.

Free Games

PandoryDX includes free, legal homebrew/shareware games. Scroll to the end of your game list to find them.

Free games

Menu Music

The DX menu is silent by default. PandoryDX adds demo music and can play your own MP3s as a jukebox.

Menu music

Advanced users: Remove spaces from MP3 filenames.

Quake

PandoryDX includes the shareware version of Quake for some classic PC nostalgia.

Quake shareware

About (PandoryTool Ultimate)

PandoryDX installs via PandoryTool Ultimate (included in the download) and can improve other Pandora variants. An installation guide is provided after download.


Pandory3D Features

Pandory3D is a set of improvements, new features, and a jailbreak for the 3D range of Pandora Box arcade boards. It fixes factory misconfigurations, prepares USB sticks to add games, and can install a jailbreak to activate optimizations and fixes.

Pandory3D overview

Game Installer

Pandory prepares a USB stick that, when inserted, installs your games/ROMs to the microSD. Game videos and titles are automatically identified and downloaded by the builtin scraper.

Game installer screenshot 1 Game installer screenshot 2

Advanced users: You can install to the USB stick itself by creating a games folder at the root. If no microSD is inserted, games install to internal NAND.

If you delete a game in the settings menu and reinstall it with Pandory, many titles are reinstalled with optimized control layouts, dualstick fixes, and 3/4player support.

Fixes are included for the following ROMs:

aburner2, aburner, astdelux, asteroid, aztarac, bbmanw, bosco, boscoo, btimem, btoads, captcomm, cclimber, chasehq, defender, dynablst, ga2, galaga88, galaga-b, galaga, galaxian, gangwars, gaunt2, gauntlet, gijoe, gwar, indyheat, kof2000, kof2000-SF2, kof2001, kof2002, kof2003, kof94, kof95, kof96, kof97, kof98, kof99, lightbr, luckywld, mk2, mk3, mk, moo, mslug2, mslug3, mslug4, mslug5, mslug, mslugx, mspacman, nbahangt, nbajam, nbajamte, offroad, offroadt, outrun, pdrift, polepos, qbert, rampage, robotron, sci, searchar, simpsons2p, simpsons, soldivid, splat, ssprint, superchs, tekken, tektagt, tmht22pu, tmht2p, tmnt2, tmnt, toobin, umk3, xmen

Advanced users: Reinstalling some Final Burn Alpha ROMs (e.g., Metal Slug and other NeoGeo titles) can enable accelerated emulated CPU settings to reduce slowdown on non3D+ models (firmware earlier than 20200714).

4:3 Aspect Ratio Correction

Classic arcade games were designed for 4:3, but the 3D range stretches to wide displays by default. Pandory3D corrects this automatically.

4:3 correction screenshot 1 4:3 correction screenshot 2

Advanced users: Use the manual aspect ratio shortcut (START + Player 1 E) to toggle modes.

Button Shortcuts

Pandory adds button combos for Android launcher access, system settings, pause menu, aspect ratio changes, and safe shutdown. These shortcuts work on internally connected controllers only.

Button shortcuts screenshot

Easy Unbrick

Some 3D models can corrupt video settings (e.g., after switching to 1080p or power loss). If the jailbreak is installed, holding Pause for ~30 seconds restores video settings.

Easy unbrick screenshot

Networking Services

Pandory enables FTP (port 7777) and Telnet (port 4444), adds USB LAN support for models without WiFi, and provides a browserbased “Pandory Remote” for installing apps or changing settings.

Networking screenshot 1 Networking screenshot 2 Networking screenshot 3 Networking screenshot 4

New Skin

Community member @supercoco contributed the “Pandory Nitro” skin, which is activated after jailbreak installation.

Pandory Nitro skin

MAME-Configs

Reinstalling games via Pandory applies optimized control configs, including dualstick fixes and 3/4player support.

MAME config screenshot 1 MAME config screenshot 2 MAME config screenshot 3

APK-Installer

Use the builtin APK installer to add compatible Android 4.4 apps and emulators.

APK installer screenshot

Moonlight

Install the Moonlight APK to stream your PC desktop and access your Steam library (LAN recommended).

Moonlight screenshot 1 Moonlight screenshot 2

Dip Switches

Hold START + Player 1 D ingame (if supported) to access the dipswitch menu for game settings like difficulty or censorship toggles.

Dip switches screenshot

Graphics Optimizations

Pandory enables GPU rendering to reduce input lag, adds MSAA for 3D smoothing, and adjusts color settings to better match original arcade hardware.

Graphics optimization screenshot 1 Graphics optimization screenshot 2 Graphics optimization screenshot 3

Safe Shutdown

Use START + Player 1 A+B+C for a software safeshutdown, since the 3D range lacks a builtin shutdown option.

Safe shutdown screenshot

Retroarch

Install the Retroarch APK to access additional emulators.

Retroarch screenshot 1 Retroarch screenshot 2

Dreamcast Save-Support

Pandory installs Dreamcast NVRAM data to enable save support and preunlock characters in some games.

Dreamcast save support screenshot 1 Dreamcast save support screenshot 2

Activate Extra Save-States

In the settings menu, hold Player 1 F to access the service menu and enable savestates for select builtin games.

Save-state activation screenshot

Playstation 1 Fixes

Pandory fixes PS1 BIOS issues and restores Tekken 1, which previously did not run.

PS1 fixes screenshot 1 PS1 fixes screenshot 2

Fixes for the PPSSPP Emulator / Games

Pandory can install optional PSP emulator fixes, including better control mappings, fixes for broken games, performance tweaks, and access to the internal PPSSPP menu.

PPSSPP fixes screenshot 1 PPSSPP fixes screenshot 2 PPSSPP fixes screenshot 3 PPSSPP fixes screenshot 4 PPSSPP fixes screenshot 5 PPSSPP fixes screenshot 6

License

PandoryTool is libre software under GPL2. Source is available on GitHub. Precompiled builds are available on itch.io; older builds are on the project website.

Videos

Discord

Need help? Ask @dajoho or @emuchicken on the Team Pandory Discord. No question is a stupid question.


Ways to Support Pandory

Pandory is free as in freedom software: the source code is free for everyone to use, study, modify, and share under GPL2.

Prebuilt Windows versions are available on itch.io for a small fee, which helps fund continued development:

If you are currently tight on budget, or unable to support the project, you can still use PandoryTool at no cost by installing the Linux versions. Older windows builds are also available from our website.

If you would like to support the project directly, you can also:

PandoryTool screenshot 1 PandoryTool screenshot 2