The original Xbox shipped with a dashboard nobody has ever quite gotten over: the green glow, the orbs, the hum. Theseus is that dashboard rebuilt plank by plank from years of reverse engineering the retail binaries, and it runs on your computer.
On macOS, Linux and Windows it goes by UIX Desktop: a launcher and media center that looks and feels like the 2002 dashboard. Your Steam library, emulators, xemu, Xbox Cloud Gaming, movies, TV and music all live in the games grid and the orbs, driven by the same scene scripts the Xbox ran.
Jump to: Get it · Set it up · Controls · Getting help · Build from source · How it works · The Xbox build · Heritage · Credits · License
- Games grid for anything you can launch: native PC games, scripts, Steam, RetroArch, ES-DE collections, Xbox ISOs through xemu, PS2 discs through PCSX2, Linux app shortcuts, and your Xbox Cloud Gaming library. Box art, favorites, recently played, time played, and the dashboard comes back when a game closes
- The guide: press the Guide button, LT+B or F7 anywhere for settings, accounts, adding and finding games, logs and help, all from a controller with its own on screen keyboard
- Title Maker (F3) for adding and editing entries by hand, with import tabs for Steam, RetroArch and ES-DE
- Media library for your Movies and TV folders, with posters from TMDB, plus Plex and Jellyfin servers. Playback runs through libmpv
- Music from your own folders, with a projectM (MilkDrop) visualizer
- Xbox Cloud Gaming and remote play: sign in with your Xbox account and your cloud games and consoles show up in the grid
- Skins: UIX Lite community skins drop in as is, and the Skin Editor helps you make your own
- CRT effect for that living room TV look: scanlines, curvature, phosphor mask, bloom, all tunable
- Controllers: Xbox, PlayStation, Nintendo and other SDL2 gamepads, any number of them, plugged in or out while it runs, with matching button prompts, rumble, and full keyboard control
- Xbox HDD browser (F5) for xemu qcow2 images and their FATX partitions
Grab the build for your OS from the Releases page.
| OS | Download | Notes |
|---|---|---|
| macOS (Apple Silicon) | Theseus-<version>-macos-app.zip |
Self contained Theseus.app. It's ad hoc signed, not notarized, so the first launch needs right click > Open, or System Settings > Privacy & Security > Open Anyway on newer macOS. |
| macOS (Apple Silicon) | Theseus-<version>-macos.zip |
Bare binary for people who already live in Homebrew. Needs brew install sdl2 sdl2_mixer mpv curl ffmpeg opus. |
| Linux x64 | UIX-Desktop-<version>-x86_64.AppImage |
One file with its libraries bundled. chmod +x it and run. This is the one for a Steam Deck. |
| Linux x64 / ARM64 | Theseus-<version>-linux-x64.tar.gz, Theseus-<version>-linux-arm64.tar.gz |
Binary plus data. Needs the runtime packages listed in docs/desktop/dependencies.md. |
| Windows x64 | Theseus-<version>-windows-x64.zip |
Unzip anywhere and run theseus.exe. Every DLL it needs is in the zip. The exe isn't code signed, so SmartScreen may ask first (More info > Run anyway). |
Rendering goes through bgfx: Metal on macOS, Direct3D 11 on Windows, Vulkan on Linux. If the default misbehaves on your machine, pick another backend under Settings > Display > Renderer and restart.
Launch it and you land on the dashboard. On first run UIX Desktop creates your user data folder and copies the starter Configs, Data and Library into it. Everything you change lives there, not next to the app, so updating means replacing the app and nothing else.
| OS | User data folder |
|---|---|
| macOS | ~/Library/Application Support/Theseus/ |
| Linux | $XDG_DATA_HOME/theseus/, which is usually ~/.local/share/theseus/ |
| Windows | %APPDATA%\Theseus\ |
Portable mode: put an empty portable.txt next to the app (beside theseus.exe on Windows, beside theseus in the Linux tarball) and everything lives in a UserData folder right there instead, handy for a USB stick or one folder per setup. An AppImage does the same with a folder named after it plus .home (UIX-Desktop-v0.4.1-x86_64.AppImage.home). Setting THESEUS_DATA_DIR points the user data folder anywhere you like and beats both.
Settings (F4) > General > Open User Directory takes you straight there. Inside:
| Path | What's there |
|---|---|
Configs/games.ini |
Every launcher entry you add: name, title ID, launch command, category |
Configs/Icons.ini |
Which icon each entry uses |
Configs/icons/ |
The icon images, named by title ID (.jpg or .png) |
Configs/desktop.ini |
Desktop settings: display, audio, CRT, library folders, sign ins |
Configs/config.ini |
Dashboard settings shared with the Xbox build (skin, clock, language) |
Data/ |
Skins, orbs, music, fonts, screenshots and the dashboard's scene archives |
Library/ |
The virtual Xbox E: drive: Games, Applications, Emulators, plus title and save data in TDATA and UDATA |
theseus.log, theseus.prev.log |
This run's log and the one before it |
When an update ships new Data (scene archives, fonts, skins), it reaches your copy on the next launch, and anything you've edited is left alone. Only the compiled shaders stay with the app itself. Settings files are written atomically, with the previous version kept beside them as .old, so a crash mid save can't eat your games list.
The quickest way is the guide (Guide button, LT+B or F7) > Games & Playlists:
- Add a Game picks a program, shortcut, ROM or disc image. Runs With sends Xbox ISOs to xemu and PS2 discs to PCSX2 (Settings > Games has Find rows for both), and a Windows program brings its own icon along.
- Import Steam Library, Import RetroArch Recent and Refresh ES-DE fill the launcher in one go, and so do Import Epic Games, Import GOG Games, Import Lutris Games and Import itch.io Games when those are installed (Heroic's Epic and GOG games count too). On Linux, Import Linux Apps reads your app menu, Flatpak and snap shortcuts.
- Search by Name, Find a Game by letter, Favorites, Recently Played and Hidden Games get you to anything. In a game list, X filters by where games come from (or Most Played, Never Played) and Y sorts All Games by name, time played or last played.
- Collections are your own groups: add a game from its page and the collection shows up in the dashboard's launcher next to Favorites. Each game's page also has favorite and hide toggles, its time played, and Arguments, Working Folder and Environment for that game alone.
For hand editing, Title Maker (F3) has every entry and the import tabs:
- Main lists every entry, whatever added it. Create one by hand with a name and a launch line: a path to an executable, a script, a
steam://link, or any shell command. Quote paths with spaces. Test Launch tries it without leaving the dashboard. Add ISO turns an Xbox ISO into an xemu entry and Add PS2 Disc a disc into a PCSX2 one (Find checks the usual install spots, RetroBat, scoop, Flatpak and AppImages). Icons can come from images,.icofiles or straight out of an.exeor.dll. - Steam finds your Steam install, and Import Steam Library brings in every installed game with its icon. Add by App ID covers betas and demos.
- RetroArch finds your install, and Import Recent Titles pulls in what you've played lately with the core and box art already sorted. Or pick a ROM and a core by hand.
- ES-DE points at your ES-DE data folder (the one holding
gamelists/). Your systems and games show up under an ES-DE category, read live on every launch.
Entries from Main, Steam and RetroArch are stored in Configs/games.ini inside your user data folder, with their icons in Configs/icons/ and the icon mapping in Configs/Icons.ini. Guide > Logs & Help > Back Up My Settings copies those and your settings into a dated folder under Backups, and Restore a Backup puts one back. ES-DE and Xbox Cloud Gaming entries are never written there; they're rebuilt each launch from their source.
The Steam, RetroArch and ES-DE tabs can be hidden under Optional Tabs at the top of Main. Hiding a tab keeps its entries. When you launch something, the dashboard fades to black and minimizes so the game gets the screen, and idles while it plays. When the game closes, its time played is added and the dashboard comes back (Settings > Games > Back to UIX When a Game Closes turns that off). Steam games count from when Steam says they're running. A launcher that starts the real game and quits right away isn't followed. Cloud and remote play streams run inside the dashboard window instead.
Settings > Media > Xbox / xCloud > Sign in to Xbox, then enter the code it shows on any device. From then on your cloud games and your consoles (for remote play) appear in the games grid with their box art.
Settings > Media > Local Library takes three folders:
- Movies: one folder per movie, or video files straight in the folder
- TV Shows:
Show Name/Season 1/episodes(orSpecials), or episodes straight in the show folder.S01E02style names set the order - Music: each subfolder becomes a soundtrack,
.m3uplaylists in the root become soundtracks too, and loose files land in one called Music
A free TMDB API key is optional; with one, posters and synopses fill in. Hit Refresh Media Library after changing folders.
Plex signs in with a PIN code. Jellyfin takes your server URL and signs in with Quick Connect. Both live under Settings > Media.
Skins live in Data/Skins/<SkinName>/ in your user data folder. Pick one from the dashboard's own settings and it swaps live, no restart. UIX Lite community skins work without conversion. A skin's <SkinName>.xbx only lists the materials it changes; anything it leaves out keeps the retail 5960 color. Tools > Skin Editor can start a new skin from Stock and tweak colors as you watch.
- Display: fullscreen (F11), borderless (F12), resolution, vsync, FPS cap, MSAA, renderer, hardware video decode, and Emulate Xbox Resolution, which frames scenes in the original 720x480 design space
- CRT Effect: Settings > Display, or View > CRT Effect. Four presets or eight sliders
- Audio: master volume, mute (Ctrl+M), and the projectM visualizer. With it on, X + Y (keys or pad) opens and closes the visualizer window
- Controller: rumble, which buttons the prompts show (follow the pad, or force Xbox, PlayStation or Nintendo), and Confirm With the Right Button for Nintendo style A and B
Every setting lives in the guide's Settings pages, and in the Settings window (F4) for mouse and keyboard.
Command line flags: --fullscreen, --4k (fullscreen plus 2x UI scale), --scale N, --no-toolbar, --muted, --minimized, --dashboard, --development.
The dashboard drives like the Xbox did: D-pad or stick to move, A to select, B to back out.
Keyboard
| Key | Xbox button |
|---|---|
| Arrow keys | D-pad |
| WASD | Left stick |
| Enter / Space | A |
| Backspace / Esc / B | B |
| X / Y | X / Y |
| Tab | White |
| ` (backtick) | Black |
| Q / E | Left / right trigger |
Video playback
| Key | Action |
|---|---|
| Esc / Q / Backspace | Stop and return to the dashboard |
| Space | Pause / resume |
| Left / Right | Seek 5 seconds |
[ / ] |
Previous / next in playlist |
| T | Audio and subtitle tracks |
Tools and windows
| Key | Action |
|---|---|
| F1 | Scene inspector |
| F2 | XAP script editor |
| F3 | Title Maker |
| F4 | Settings |
| F5 | Xbox HDD browser |
| F6 | Playlist Maker |
| F10 | Show or hide the menu bar |
| F11 | Fullscreen |
| F12 | Borderless window |
| Ctrl+M | Mute |
| Ctrl+R | Restart the dashboard |
On a Mac, Cmd works in place of Ctrl.
Controller in the tool windows
Guide > Desktop Tools > Use the Tools with the Pad hands the pad to the tool windows. A prompt bar along the bottom shows what each button does right now.
| Input | Action |
|---|---|
| Stick / D-pad | Move |
| A | Select |
| B | Back out one layer, then leave pad mode |
| Y | Open a text field with the on screen keyboard |
| Hold X | Move and resize windows |
The Skin Editor stays mouse and keyboard only.
Found a bug? Open an issue or find us on the TeamUIX Discord. Please include:
- Your OS and version, and your GPU if it's a display problem
- Which download you're running: the file name carries the version and package. Help > About UIX Desktop shows it too
- What you did, what you expected, and what happened instead
theseus.logfrom your user data folder (see First run). If it crashed on the previous launch, attachtheseus.prev.logas well. A crash also leaves a report in thecrashesfolder there; attach the newest one
On Windows, starting theseus.exe from a terminal sends the log to that terminal instead of the file.
Please don't post Configs/desktop.ini as is: it holds your Plex, Jellyfin and Xbox sign in tokens.
The full walkthrough is in docs/desktop/building.md, and the libraries per OS are in docs/desktop/dependencies.md. The shape of it on macOS or Linux:
git clone --recursive https://github.com/MrMilenko/Theseus- Install the build packages for your OS. Everything is found through
pkg-config, so any package manager works - Build the bgfx runtime libraries and libdatachannel once. Skip libdatachannel and xCloud quietly drops out of the build
cd build && make desktop, then run~/builds/theseus/desktop/theseus
Windows builds cross compile with mingw (make desktop-win64), and there's a Linux ARM64 cross target (make desktop-linux-arm64). Scripts for the macOS .app and the Linux AppImage live in build/.
For contributors: only theseus/desktop/host_* talks to the operating system. make lint-platform enforces that, and make win64-import-guard catches stray Win32 calls. CI runs the lint and builds macOS, Linux and Windows on every push.
The dashboard is a scene graph driven by XAP, a small scripting language compiled to bytecode, with scenes, meshes and textures packed into .xip archives. Theseus reimplements the engine underneath: the script VM, the VRML flavored scene graph with its FND/PRD reflection tables, asset loading, text, materials, audio and input. The scripts and archives run unmodified, which is why the scene node interface is treated as a contract (docs/xap-contract.md).
On desktop, the dashboard's Direct3D 8 calls land on a thin shim that drives bgfx, Xbox drive paths map onto your user data folder, and SDL2 handles windows, input and sound.
theseus/
engine/ Pure logic: script compiler, math, locale
shared/ Both builds: script VM, files and titles, settings, keyboard
render/ Both builds: scene graph, materials, shapes, text
desktop/ Desktop only: SDL main loop, bgfx shim, host_* OS layer, tools, media, launchers
xbox/ Xbox only: kernel and hardware glue
toolbox/ Xbox only: FTP and drive tools from the PrometheOS lineage
theseuslib/ C library: XISO and XIP parsers
xips-source/ Editable source for the scene archives Theseus adds or changes
Documentation index: docs/README.md. What we found in the dashboard binary, subsystem by subsystem: docs/decomp/.
The same engine still compiles for the original Xbox as a replacement dashboard, built with OXDK through build/Makefile.xbox. It's a work in progress and isn't part of the desktop releases. If you want a custom dashboard on your console today, use UIX Lite, where TeamUIX's console work currently lives.
Building it needs clang and lld-link, OXDK, and an Xbox SDK tree of your own linked at theseus/xdk (it isn't in this repo):
cd build
make -f Makefile.xbox CONFIG=retail # or CONFIG=debug
The XBE lands in ~/builds/theseus/xbox-retail/ (or xbox-debug/). On the console it expects uixdata\ beside the XBE, mounted as Q:, and its configs in C:\UIX Configs\. If something's missing at boot, the panic screen tells you what.
Theseus is part of the TeamUIX lineage. JbOnE created User.Interface.X (UIX), a source level modification of the original Xbox dashboard, and a lot of what we know about how the dashboard behaves came from years of living with it. Modern TeamUIX carries that on with UIX Lite, a heavily patched retail dashboard, and with Theseus.
UIX changed the dashboard from the inside. Theseus reaches the same place from the other side of the river: Ghidra analysis of the retail dashboard binaries from 4920 through 5960, custom Ghidra scripts that pull the dashboard's own FND/PRD descriptor tables out of the binary, disassembly where the decompiler gets it wrong, every name checked against the XAP scripts that call it, and two decades of community changes to the XIPs untangled along the way. The findings are written up per subsystem in docs/decomp/.
For the wider UIX story, see UIX History.
TeamUIX
- Milenko: reverse engineering and development, UIX Desktop
- BigJx: UIX Lite XIPs (XAP scripts, skins, scene assets), testing, bug reports
- Rocky5: skin presets and the Colourizer XBE color patcher (the technique descends from ZogoChieftan's in dashboard color patching in BlackStormX, circa 2004)
- JbOnE: the original UIX, the lineage Theseus continues
Upstream code
- Team Resurgent: PrometheOS (the Xbox toolbox is forked from it via UIX Lite Toolbox) and Hermes (ISO/CCI mounting on Xbox)
Libraries: SDL2, SDL2_mixer, libmpv, libcurl, FFmpeg, Opus, OpenSSL, libdatachannel, bgfx, bx, bimg, projectM, Dear ImGui, ImGuiColorTextEdit, imgui-filebrowser, stb and minimp3. Licenses and links are in LICENSE-THIRD-PARTY.md.
Theseus is licensed under the GNU General Public License, version 3 or later (GPL-3.0-or-later). Full text in LICENSE.
Inherited code keeps its own license (theseus/toolbox/ from PrometheOS via UIX Lite Toolbox is GPL-3.0; Hermes is GPL-3.0). The XIPs and skin assets shipped in Data/ are TeamUIX's UIX Lite work and ship under GPL-3.0-or-later.




