* feat(stores): one Manage stores sheet for order, visibility and accounts Store order, which stores show, and signing in or out now live in one slide-over, the same one Edit tabs uses, with the same sorter: drag the handle, or Y to grab and the d-pad to move, A to show or hide. - The Library's chip row opens it from a sliders chip at its start, in place of the Store accounts button at the end of the row. The Stores tab's Arrange tabs opens the same sheet instead of rearranging the chip row in place. - Each store row shows its account and one action: Sign in, Sign out, Reconnect when the login expired, or Add key for itch.io. - A switched-off store leaves the Library's chips too; its games stay under All. A shown store that is signed out keeps its chip, and picking it shows the Stores tab's sign-in card in the Library. - The Stores tab, the Library's chips and the sheet share one store order. EditTabsSheet and the new sheet share SideSheet, and the tab and store lists share SortableRows. Sign-in from the Stores tab, the sheet and the Library goes through startStoreSignIn. * feat(library): Library chips match the Stores tab, cards fade in on a store change, and the sheet only arranges The Library's chip row uses the Stores tab's chips, store-colored theme and sliding fill. Switching store fades and lifts the visible cards in, staggered, and still when animations are off. Sign-in now lives on each store's own tab, so Manage stores drops its account buttons and keeps order and show or hide, with each account as a line of text. * feat(library): chips at the top, the chosen chip's toolbar under them, and a Custom games tab The Library drops its title row and game count. The store chips are the top row, and under them the chosen chip's name sits beside search, display, sort, view and the game file actions, as in the Stores tab. The add button that sat in every header becomes a Custom games chip that is always there: empty, it opens on a card that adds a game file or a folder of games; with games in it, its toolbar has the add button. * feat(library): store-colored focus in the Library, an aligned All chip, and sign out from a store's toolbar The Library's grid takes the chosen store's theme, so focus rings and accents use its color as on the Stores tab's pages. All gets a grid mark where the other chips have a dot, so its label lines up, and the Manage stores chip matches the chips' height. A signed-in store's toolbar has an account button that asks before signing out, with the Stores tab's wording. * feat(library): drop the chosen store's name from the toolbar The chip above already names it, so the toolbar starts with search. * fix(library): an empty library keeps its chips, so Custom games and a store's sign-in stay reachable With no games and no store signed in, the Library used to switch to a separate empty page without chips. It now shows the chips and toolbar like any other library, with the empty-library note under All games. * fix(library): no toolbar between the chips and a sign-in or empty Custom games card The search, display, sort and view row has nothing to act on there, so the card sits right under the chips, as it does in the Stores tab, and Down from the chip reaches its button. * fix(library): sign-in and empty Custom games cards fill the space under the chips They were a fixed 300 dp, which left the bottom of the screen empty once the toolbar above them was gone. They now take the grid's height minus the chip row. * fix(library): drop the Installed label and lighten the cards' left fade The Not installed row already divides the two sections, so the Installed label above the first games goes. The dark fade on the left of the store sign-in card and the Steam tab's art wall is lighter, so more of the art shows while the title stays readable. * Library: share the hero wall card and wall fade; icon handle for sign out The Custom games splash is now built from the same card as the store sign-in splash, with a drifting wall of the library's covers instead of a flat gradient and no hint text. The sign-in card and the Steam tab share one wall fade. The sign-out step shows the account icon as its handle, like the other toolbar steps, instead of a truncated label. * Library: sort the Custom games tab in Manage stores; keep search reachable Opened from the Library, the Manage stores sheet lists Custom games among the stores so it can be grabbed and moved like them. Its place is saved as the store it follows, so hiding that store or a new store arriving keeps it where it was. It has no switch: the tab is always there. The Custom games splash no longer replaces the toolbar while a search is active, so a search that matches nothing can still be cleared. * Manage stores: sort Favorites, Steam and Custom games; hide Favorites and Custom games Opened from the Library, the sheet lists the Library's own tabs among the stores. Each one's place is saved as the tab it follows, so hiding a store or a new store arriving leaves it where it was. Favorites and Custom games have a switch; Steam can be moved but not hidden. The sheet takes focus only in controller mode, so opening it by touch no longer switches to controller focus and its ring. Picking up a controller while it is open moves focus into it. Hidden games stay off the Custom games cover wall. * Library: keep an expired store's tab and offer sign-in when nothing is cached An expired account no longer drops its Library tab when it has no cached games: the tab stays and opens on the sign-in card, as on the Stores tab. With cached games it keeps listing them.
DroidDeck brings the SteamOS experience to Android: Steam Gaming Mode, full Linux desktop, integration with GOG, Epic Games, Xbox, and other storefronts, Steam VR, and more!
100% open source. No ads. No telemetry. No proprietary components. No source withheld.
The official website is droid-deck.dev. Only download DroidDeck from this repository's Releases.
Install
- Android 9 or newer on Adreno 730 or newer, or any 8xx. Adreno 6xx, Mali, Xclipse and PowerVR are experimental. Adreno 710 is currently unsupported. No root needed.
- About 3 GB free for the runtime, plus 1.1 GB for the desktop and emulators.
- Install the APK, install the Linux runtime, press Play and sign in to Steam.
- On Android 14 and newer, turn on Disable child process restrictions in Developer options. On Android 12 and 13, Steam's first launch shows a Fix it for me button that walks you through it.
Smart glasses setup is in the support matrix. Release notes are in docs/releases.
Help, Preview builds and device reports are on Discord. For bugs, post in #bug-reports with the zip from Share logs.
Build
Needs Docker, Java 17, the Android SDK and NDK, Rust via rustup, Go, a host C compiler, the x86_64 and i686 MinGW-w64 compilers (i686 with DWARF-2 exceptions, as Debian and Ubuntu ship it; SJLJ builds such as Homebrew's cannot link Rust's i686-pc-windows-gnu), GitHub CLI, Python 3 and zstd. On x86_64 Linux, Docker also needs an arm64 binfmt handler (docker run --privileged --rm tonistiigi/binfmt --install arm64).
tools/build_local.sh
The APK lands in app/build/outputs/apk/release/. Install it with tools/deploy_local.sh. After the first run, ./gradlew :app:assembleRelease reuses the prepared inputs. Unit tests run with ./gradlew -PskipRust=true :app:testDebugUnitTest, and the helper and preload suite with bash tools/test_local.sh.
On Windows, see tools/run_windows.ps1 and tools/prepare_windows_runtime.py.
Limits
Compatibility and performance vary by device. Desktop compositing is software rendered, and Firefox sandboxing is reduced under proot.
Credits and licence
DroidDeck is GPL-3.0. Steam and Proton belong to Valve Corporation. VITURE, RayNeo, XREAL, Rokid, REDMAGIC, Nintendo Switch and Joy-Con are trademarks of their owners. This project is not affiliated with any of them.
Runtime, Wine and Proton
- Runtime, shim, input and controller work build on WinNative and Bannerlator by maxjivi05.
- mmap ring buffer controller input by ribbit384 (WinNative #345).
- FEX (MIT) runs x86 code. DroidDeck's build puts the platform name under
AT_PLATFORMso sharun AppImages by VHSgunzo (MIT) start through its userland-execve loader (MIT), and its GL thunk hands X errors to the program's own error handler. FEX's code disk cache was checked in its source. - x86 AppImages, and arm64 ones whose runtime can't unpack on Android, are unpacked with uruntime by VHSgunzo (MIT), shipped unmodified with its licence.
- x86 programs linking OpenSSL 3 use the copy in the Steam Linux Runtime 4.0. x86 Linux games get the
/etc/asound.confthat pressure-vessel writes. WriteProcessMemoryhooks fall back to/proc/<pid>/memthe way Wine'sserver/ptrace.cdid before Wine 11.- Windows programs on noexec storage get executable copies of their image pages, following @yujikaido's finding in droiddeck-rp4pro that Wine's own processes need the noexec shim.
- Wine write watches use userfaultfd support in Proton's
dlls/ntdll/unix/virtual.c(LGPL-2.1-or-later). libddsession supplies the arm64 syscall number and answersPAGEMAP_SCANfrom/proc/self/pagemap. - libddsession runs Wine's arm64
SIGUSR2context handler (dlls/ntdll/unix/signal_arm64.c, LGPL-2.1-or-later) in place on a frame laid out like Linux'sarch/arm64/kernel/signal.c, and servesfill_vm_countersindlls/ntdll/unix/process.cthe kernel's own/proc/<pid>/status. - droiddeck-ntsync follows the Linux ntsync semantics in
Documentation/userspace-api/ntsync.rst(GPL-2.0). - The proot fast path orders bindings like PRoot's
path/binding.c(GPL-2.0-or-later). - DiRT 3 and DiRT Showdown keep their telemetry socket the way RoccoC's DiRTTelemetryErrorFix (MIT) does, based on the fix by Carsten Gottschling.
- Zink on PowerVR keeps colour textures in colour with Icenowy Zheng's upstream Mesa fix d55418dae7 (MIT), carried as a runtime patch.
- Games and AppImage, Flatpak and Snap programs such as emulators use
TU_DEBUG=sysmemby default, as does the Steam client. Turnip sysmem rendering can be turned off in Performance settings, except with the Adreno 710/720 driver, which always uses it. - Black Ops III and Dark Souls Remastered start without umu-protonfixes (BSD-2-Clause), whose
311210.pyand570940.pyfail under ARM64 Proton. - ReSkate (GPL-3.0) by Dingo Shenanigans uses the launch option from its README and D3D12 feature level 12_1.
- The arm64 client's sign in was checked by reading Steam's saved token with the
ConnectCacheformat from deadlock-api-ingest.
Stores
- Epic Games and GOG build on Phobos's adaptation of Legendary and gogdl. GOG install script registry entries are read the way Heroic Games Launcher (GPL-3.0) reads them. GOG cloud storage requests send the Galaxy communication-service User-Agent that gogdl and Lutris (GPL-3.0) send.
- Epic's official Linux launcher preview runs through FEX. That setup is outside Epic's listed Linux support.
- The launcher's .deb gets the WebKitGTK and GTK 3 libraries it needs from unmodified Debian 13 packages, following @zooluis's research in #2268.
- Battle.net is by @kayakyakr. It runs Blizzard's own client in Proton (downloaded from Blizzard, not included) and shows key art from the Battle.net Shop. Without Steam, its games see the pad as an Xbox 360 controller via
PROTON_SPOOF_STEAMINPUT_VIDPIDin Proton'sdlls/winebus.sys. - The EA store follows the EA app's protocols as documented by ArmchairDevelopers' Maxima (GPL-3.0): sign-in, the GraphQL queries (included verbatim, since EA matches them by hash), build archives, online activation licences and the LSX game endpoint. The code is DroidDeck's own.
- Battle.net installs drive Blizzard's Agent the way @barncastle's Battle.Net-Installer does, with requests from wowdev.wiki. Read without taking code: @mubaraknumann's unifideck, @djmittens's neo-mittens
bnetswitch, @BCD1210's soju and Lutris'sproduct.dbreader. - The Rockstar launcher service looks for launcher pipe names in the executables beside the game, since CitizenFX's
ros-patches-fiveshows GTA V openingGTAVLauncher_Pipeand @pingod's rdr2-linux-launcher notes that Rockstar's protected executables resolve such strings only at run time. Read without taking code. - World of Warcraft addon imports replace an addon's folder from a temporary copy, as WowUp does, and read flavour folders the way WoWDeck does. No code from either is used.
- The World of Warcraft addon Download window searches WoWInterface through its MMOUI API. CurseForge opens in the user's browser, with no API and no key.
- The Xbox store runs @domsvoboda's nexus-backend 0.2.15 (GPL-3.0, a fork of Xodus), and Xbox games load the Windows modules of his nexus-runtime (LGPL-2.1-or-later), including the C++ nexus-xgameruntime and
wintypes.dll. Content licensing sends delegation-compact device tickets in the licensing wire form, as nexus-backend's Store license path (commit27c335e) does. Minecraft's GameInput setup was checked against @Wyze3306's BedrockOnLinux (MIT). - The Xbox Cloud Gaming player uses the WebRTC client of @unknownskl's Greenlight (MIT), and its offer tweaks and sharpening follow @redphx's Better xCloud (MIT). See
tools/xcloud-player/NOTICE.md. - The itch.io butler pack ships butler's
7z.so, itch.io's build of 7-Zip by Igor Pavlov (LGPL-2.1, unRAR restriction on RAR code), unmodified. Other archives use Apache Commons Compress and the runtime's bsdtar (libarchive). - The Store uses Flatpak (LGPL-2.1) through DroidDeck's own bubblewrap shim. Chromium and Electron apps start directly, since zypak by @refi64 (BSD-3-Clause) always uses Flatpak's spawn portal.
- Folder sync runs Syncthing (MPL-2.0), built from @researchxxl's syncthing-android fork (MPL-2.0).
Audio, video and HUD
- Steam audio goes through @The412Banner's DirectAudio PulseAudio sink (LGPL-2.1-or-later), built from
tools/directaudio/sink. - The DroidDeck HUD is @The412Banner's FusionHUD (GPL-3.0 with an attribution term). Its readings match Valve's MangoHud build (MIT), with frame times from gamescope patch 0125.
- The HUD's CPU, GPU load, thermal and battery readers come from @xXJSONDeruloXx's work.
- LSFG frame generation comes from Camille LaVey and the Eden project, following lsfg-vk, ported by @maxjivi05. It needs your own copy of Lossless Scaling and ships none of its shaders.
- Black frame insertion follows the design of @artzox's BFI Presenter (GPL-3.0): the strobe runs on the display's refresh clock and the game is paced to the lit refresh. Both build on Blur Busters' research on MPRT and motion blur. No BFI Presenter code is used.
- Remote Play decodes through Android's MediaCodec or the FFmpeg (LGPL-2.1-or-later) in Steam's runtime. Qualcomm low latency settings follow Moonlight (GPL-3.0).
- PipeWire (MIT) sockets use the settings in its
module-access.c, and WirePlumber (MIT) keeps those clients at full permissions.
Desktop
- The KDE pacman repository snapshots Arch Linux ARM and installs with pacman (GPL-2.0-or-later).
- KWin (GPL-2.0-or-later) is patched to pass on the scroll data its
wayland_backend.cppleaves as a TODO. - Read without taking code: Qt's
qwaylandinputdevice.cppandqguiapplication.cpp, Konsole'sTerminalDisplay.cpp, and Mesa'su_threaded_context.candzink_resource.c. - The Steam Keyboard window rule follows Valve's
steamdeck-kde-presetswith Bazzite's0001-steam-virtual-keyboard.patch. - Steam's Browse buttons open a GTK 3 file chooser via PyGObject (LGPL-2.1-or-later), shown over Steam by gamescope (BSD-2-Clause) through
GetAppIdFromReaper. - The AYN Odin 2 phantom second display was confirmed by @SapphireRhodonite's WatermelonDS 0.0.5 notes and iiSU #363, without taking their code.
Smart glasses
- Builds on WinNative's VITURE work. Protocol checked against @wheaney's XRLinuxDriver, @badicsalex's ar-drivers-rs and go-macos/iokit. The optional VITURE SDK is not included.
- The VITURE protocol V2 frames adapt @elasticjava's viture-v2 (MIT) by Holger Bartnick. See
docs/third-party/viture-v2. - RayNeo adapts @informalTechCode's RayNeo-Air-Series-3DoF-Scaffold (Apache-2.0) and references @verncat's RayNeo-Air-3S-Pro-OpenVR (MIT) and Monado (BSL-1.0). See docs/third-party/rayneo.
- XREAL 1S references XRLinuxDriver and xrealOneDeviceKit by @wheaney, @rohitsangwan01's xreal_one_driver (MIT) and @0xcaff's xr-tools.
- Rokid follows ar-drivers-rs, @badicsalex's Void Computing write-ups and Monado's Rokid driver.
- REDMAGIC display findings draw on @mekhontsev's MagicDesk investigation and @Coding-BR's decompiled Nubia kernel.
VR, Joy-Con and hand tracking
- Joy-Con VR ports the arm model from Google's GVR SDK for Unity (Apache-2.0) and adapts the hand skeleton from Valve's OpenVR
handskeletonsimulationsample (BSD-3-Clause), which follows Moshi Turner's work in Monado. Index offsets come from Monado'svive_poses.c(BSL-1.0). - Joy-Con research: Linux's hid-nintendo by Daniel J. Ogorchock, @dekuNukem's Nintendo_Switch_Reverse_Engineering, SDL and AOSP. Checked against ALVR, OpenComposite, PSMoveSteamVRBridge, @F8LEFT's JoyConVr, @krnelpan1c's Daydream-Controller-SteamVR, @yoyobuae's joyconvr, Moonlight and Dolphin. See docs/third-party/joycon.
- Camera hand tracking runs Google's MediaPipe Pose Landmarker (Lite), BlazePose GHUM 3D and Hand Landmarker (Apache-2.0) on CameraX frames (Apache-2.0), with usage reports off. Checked against JoyConVr's camera app (MIT).
- Tracking math: the GVR arm model's accelerometer mode, Eric Foxlin's zero velocity updates, Frosio, Pedersini and Borghese's accelerometer autocalibration, a Kalman filter (Kalman, 1960), Horn's quaternion method (1987) and the 1€ filter (Casiez, Roussel and Vogel, 2012).
- Gestures follow ALVR's
hand_gestures.rs(MIT) and Meta Quest's menu pinch, tuned on HaGRID photos (CC BY-SA 4.0, not included). - The glove model follows OpenVR's render model reference, is meshed with surface nets (Gibson, 1998; Mikola Lysenko), and uses Inigo Quilez's smooth minimum, distance field ambient occlusion and polygon distance (MIT). See docs/third-party/handtracking.




