Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

enjoyerofslop/droidplay-core

Games

Build your own dumped Switch games into native Android apps and run them through Vulkan on an arm64 phone or handheld.

113
3
Python
MIT
4 days old

What it does

DroidPlay Core is the Android engine behind DroidPlay: it takes a Nintendo Switch game you dumped yourself and builds it into an Android app. A Switch and an Android phone both execute ARM64, so the game code is rewritten only where the host differs (system calls, thread registers), a host layer answers Horizon system calls and SDK services, and the game's NVN graphics are replayed on the phone GPU through Vulkan, with shaders translated to SPIR-V at build time. The project descends from seedds/nxnative, whose iOS/macOS host was ported to Android; the port began with RogelioLB/nxnative-android.

It is aimed at players who own a Switch and want to run their own games on an arm64 Android phone, handheld or tablet, and at developers working on the Android host and Vulkan replay.

Get started

Prerequisites: a Windows 10 (1809+) or Windows 11 64-bit PC, an Android 10+ arm64 device with a Vulkan GPU, a USB cable (or wireless debugging), and your own dumped game files plus prod.keys. Windows needs about 6 GB for DroidPlay and the build tools, plus space for each game's extracted files and shader translation on the drive holding the game.

  1. Download DroidPlay-Setup-<version>.exe from the latest release and run it. Windows warns that the file is unsigned; the README instructs choosing More info then Run anyway. It installs per-user without an administrator prompt.
  2. In DroidPlay's Get started checklist, select your prod.keys, click Install tools to fetch the JDK, .NET SDK and Android SDK (about 1.5 GB download, with a license prompt), enable USB debugging on the phone, plug it in and tap Allow, then Set up my phone.
  3. Add the folder containing the game's NSP/XCI files and click Build and install. The first build takes roughly 10–20 minutes; later builds reuse unchanged work.
  4. Press Play in the Library or open the DroidPlay app on the phone. The first launch spends a minute or more preparing shaders; later launches take a few seconds.

Alternatives: the Mac front end DroidPlay can build and install Android games, and on Windows, macOS or Linux the command-line script scripts/build_android_from_nsp.py packs a game from the terminal.

Constraints

Requires an arm64 Android 10+ device with a Vulkan GPU; Adreno has had the most testing, with Mali and Xclipse newer to the project. A GPU driver can optionally be replaced with a Turnip build on Adreno. Each game must be dumped from your own console as NSP/XCI files with your prod.keys; Switch 2 titles use a .nup file or dump folder and no keys, but are at an early stage on Android. Compatibility varies by title and device, and the game status list records tested results and issues per game. Game builds are personal and must not be shared, since an APK carries the game. The project is MIT-licensed, with third-party components under their own licenses.

HotRepo's take

The project appears on HotRepo's new-project list for Python on 2026-11-12, gaining 3 stars over about an hour and reaching 105 stars in total. That is a single short observation window, so it does not establish a trend; what stands out in the materials is the depth of the documentation (per-game notes, device baselines, a reference on Android Vulkan replay) rather than the star count. The engine builds on an existing native-execution lineage and frames Android support as an active port rather than a completed product.

HotRepo's take

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. drakolordx7/pokopia-recompRuns a recompiled Switch 2 Pokémon game natively on Windows using your own game dump.C++510
  2. drakolordx7/switch2-recompRecompiles Pokémon Pokopia from Switch 2 to run natively on Windows PCs.C++507
  3. seedds/nxnativePacks your own Switch and Switch 2 game files into native Apple silicon Mac apps or sideloadable iOS IPAs.Python14,530
  4. LNPANDY/NX2AppleA macOS/Windows launcher that builds your own Switch game dumps into native apps for Apple silicon Mac, iPhone and iPad.Swift4,445
  5. xFractals/pokopia-nativeRebuild your own Pokémon Pokopia dump into native Windows, Mac, iPhone, Android and Linux builds.C447