download

the steam deck package adds the gaming mode installer and artwork. both packages use the same gdox and xemu build.

check it before installing:

curl -O https://gdox.korze.org/downloads/0.1.3/SHA256SUMS
curl -O https://gdox.korze.org/downloads/0.1.3/SHA256SUMS.minisig
curl -O https://gdox.korze.org/minisign.pub
minisign -V -p minisign.pub -m SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing

source: gdox and xemu. the same files are attached to the v0.1.3 release on github.

before you start

• 64-bit x86 linux, glibc 2.38 or newer, GLIBCXX 3.4.31
• an X11 desktop, OpenGL, and a game controller
• a compatible stock dvd drive
• your own 512-byte MCPX 1.0 rom and compatible xbox bios

keep the extracted folder together. gdox looks for xemu, its libraries, and the hdd next to the launcher.

desktop linux

1. extract the complete linux archive.
2. open a terminal in the extracted folder.
3. run sudo ./setup-device-access.sh once.
4. start gdox with ./gdox.
5. open sources, add your mcpx rom and bios, connect the drive, then insert the disc.

optional: run ./install.sh to add gdox to your application menu.

setup-device-access.sh installs the optical-drive udev rule. gdox then runs as your normal user.

steam deck

1. switch the deck to desktop mode and extract the complete steam deck archive.
2. open the folder and run install.sh.
3. complete the one administrator prompt for optical-drive access.
4. return to gaming mode and open gdox from the non-steam library.
5. add your firmware on sources, connect the drive, and insert the disc.

the installer adds one non-steam shortcut with artwork, and updates it if you run it again.

d-pad and A to navigate, LB/RB to change pages, quit at the top right to exit. while a game runs, gdox hides and hands the controller to xemu.

if the deck account has no administrator password, set one once with passwd in konsole before running the installer.

distro notes

• arch linux and steamos
• ubuntu: 24.04 LTS or newer
• debian: 13 or newer
• fedora: any current release

this release is a plain archive, not a flatpak, appimage, deb, or rpm. other formats may come later.

updates and user data

• application: ~/.local/opt/gdox
• preferences and imported firmware: ~/.config/gdox
• writable hdd and saves: ~/.local/share/gdox

reinstalling or replacing gdox leaves that data alone.