| .forgejo/workflows | ||
| build | ||
| docs | ||
| stub | ||
| tool | ||
| .clang-format | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| HISTORY.md | ||
| LICENSE | ||
| meson.build | ||
| README-cy.md | ||
| README-de.md | ||
| README-es.md | ||
| README-fr.md | ||
| README-it.md | ||
| README-ja.md | ||
| README-pt.md | ||
| README-ru.md | ||
| README-zh.md | ||
| README.md | ||
PandoryTool for Pandora Box Arcade Systems
PandoryTool is a Swiss‑army‑knife 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 Dual‑Boot DX‑Vertical (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
- Create the backup USB stick:
Example:pandory stick backup <destDrive>pandory stick backup F:\ - When prompted, select the matching 3D/3D+ variant.
- 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)
- Create the jailbreak USB stick:
Example:pandory stick jailbreak <destDrive>pandory stick jailbreak F:\ - When prompted, choose
[1]for Pandora Games 3D / Saga 3D (up to 20200217 firmware) or[2]for Pandora Games 3D+ (20200704 and later). - Tutorial video: Jailbreak Pandora Games 3D / 3D+ / EX2 https://www.youtube.com/watch?v=cWdxBeuhXKU
3) Add games for 3D models
- Prepare ROMs for your device:
Example:pandory add <sourceDir> <destDir>pandory add C:\roms F:\ - 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
- Prepare a clean exFAT USB stick and note its drive letter (example
F:\). - Create the Stage 1 installer on that USB stick:
Example:pandory pspfix stage1 <destDrive>pandory pspfix stage1 F:\ - Safely eject the USB stick, boot the Pandora with its normal microSD, and insert the stick once to install the PSP injector.
- Power off, remove the Pandora microSD, insert it into your PC, and note its drive letter (example
G:\). - Apply Stage 2 directly to that microSD:
Example:pandory pspfix stage2 <destDrive>pandory pspfix stage2 G:\ - Safely eject the microSD and put it back in the Pandora.
- Tutorial video: https://www.youtube.com/watch?v=_V6lSL9VPzI
5) Installing the PandoryDX improvements (DX models)
- Apply DX improvements to your DX microSD/USB:
Example:pandory stick dx <destDrive>pandory stick dx F:\ - 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
- Create the jailbreak stick:
pandory stick jailbreak <destDrive> - When prompted, choose
[3] - Pandora Key 7(requires a micro‑SD 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 micro‑SD or USB so you can remove it anytime.
Skins
PandoryDX adds a new skin, removes the menu “click” sound, and lets you swap Pandora DX logos and graphics.
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.
Advanced users: You can override aspect ratio globally or per‑game using forceHeight in pandory.xml on your micro‑SD/USB.
Sharp Pixels / Blur Removal
DX boards scale low‑res games up and add blur. PandoryDX removes the blur and can apply optional integer scaling for crisp pixels.
Advanced users: Blur can be re‑enabled in pandory.xml for low‑resolution arcade monitors.
Final Burn Alpha Core Clock Boost
Final Burn Alpha simulates original slow‑down (e.g., Metal Slug 2). PandoryDX can overclock the emulated CPU for smoother play.
Advanced users: Disable this in pandory.xml if you want original slow‑down behavior.
Dipswitches
Hold START in‑game to open the dipswitch menu (when supported) and tweak settings like difficulty or censorship.
Smoother Scrolling
PandoryDX optimizes graphics settings for smoother scrolling, especially over HDMI.
Character Unlocks
Some stock games hide characters. PandoryDX includes presets that unlock them by default.
Buttons Reconfigured
PandoryDX fixes misconfigured controls and lets you define custom remaps in pandory.xml.
King of Air 2 – Aspect Ratio Correction
The KOA2 vertical variant can display vertical games at the wrong width. PandoryDX corrects this.
Attract-Mode
DX auto‑inserts coins in freeplay, which hides attract‑mode demos. PandoryDX disables auto‑coin for a more authentic arcade feel.
Advanced users: You can disable this in pandory.xml.
Improved Scanlines
Factory scanlines are thick and ugly. PandoryDX uses a low‑CPU “JPINO‑Royale” scanline preset.
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.
Advanced users: You can re‑enable 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 micro‑SD/USB.
Note: Some systems (e.g., Amiga) require Kickstart/BIOS files you provide.
TATE Mode
PandoryDX can auto‑rotate vertical games or let you rotate manually to fit a vertical screen.
Advanced users: Enable this in pandory.xml and use it for horizontal games on vertical screens if needed.
Custom Cores
Some games launch with sub‑optimal emulators out of the box. PandoryDX can auto‑switch ROMs to better cores for performance or controls.
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.
Menu Music
The DX menu is silent by default. PandoryDX adds demo music and can play your own MP3s as a jukebox.
Advanced users: Remove spaces from MP3 filenames.
Quake
PandoryDX includes the shareware version of Quake for some classic PC nostalgia.
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.
Game Installer
Pandory prepares a USB stick that, when inserted, installs your games/ROMs to the micro‑SD. Game videos and titles are automatically identified and downloaded by the built‑in scraper.
Advanced users: You can install to the USB stick itself by creating a games folder at the root. If no micro‑SD is inserted, games install to internal NAND.
If you delete a game in the settings menu and reinstall it with Pandory, many titles are re‑installed with optimized control layouts, dual‑stick fixes, and 3/4‑player 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 Neo‑Geo titles) can enable accelerated emulated CPU settings to reduce slowdown on non‑3D+ 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.
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.
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.
Networking Services
Pandory enables FTP (port 7777) and Telnet (port 4444), adds USB LAN support for models without Wi‑Fi, and provides a browser‑based “Pandory Remote” for installing apps or changing settings.
New Skin
Community member @supercoco contributed the “Pandory Nitro” skin, which is activated after jailbreak installation.
MAME-Configs
Reinstalling games via Pandory applies optimized control configs, including dual‑stick fixes and 3/4‑player support.
APK-Installer
Use the built‑in APK installer to add compatible Android 4.4 apps and emulators.
Moonlight
Install the Moonlight APK to stream your PC desktop and access your Steam library (LAN recommended).
Dip Switches
Hold START + Player 1 D in‑game (if supported) to access the dipswitch menu for game settings like difficulty or censorship toggles.
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.
Safe Shutdown
Use START + Player 1 A+B+C for a software safe‑shutdown, since the 3D range lacks a built‑in shutdown option.
Retroarch
Install the Retroarch APK to access additional emulators.
Dreamcast Save-Support
Pandory installs Dreamcast NVRAM data to enable save support and pre‑unlock characters in some games.
Activate Extra Save-States
In the settings menu, hold Player 1 F to access the service menu and enable save‑states for select built‑in games.
Playstation 1 Fixes
Pandory fixes PS1 BIOS issues and restores Tekken 1, which previously did not run.
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.
License
PandoryTool is libre software under GPL2. Source is available on GitHub. Pre‑compiled builds are available on itch.io; older builds are on the project website.
Videos
- Pandory3D Jailbreak Video (1.0.4): https://www.youtube-nocookie.com/embed/lh_I9Gp-4v4
- Pandory3D Jailbreak Update (1.0.5): https://www.youtube-nocookie.com/embed/fMlLI08k7yk
- Pandory3D Jailbreak Update (1.0.7): https://www.youtube-nocookie.com/embed/lFE7w1PFvNk
- Pandory3D Jailbreak Update (1.0.8): https://www.youtube-nocookie.com/embed/0F2s0Mca6gI
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:
- Purchase on itch.io: https://teampandory.itch.io/pandorytool
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:
- Donate a coffee: https://www.buymeacoffee.com/CKZbiXa
- Join Patreon: https://www.patreon.com/pandorytool