sohzm/winedroid
System ToolsAn experimental Android compatibility layer that runs APKs on Linux, macOS and in the browser without an Android OS.
What it does
WineDroid is an experimental Android compatibility layer for Linux, macOS and the browser, modeled after Wine: it runs Android APKs directly rather than booting an Android system. It executes DEX bytecode, implements parts of the Android framework, and renders app interfaces with Skia. Desktop builds add a Cranelift JIT; the WebAssembly build reuses the same runtime and renderer through an interpreter.
The project is in very early development. Some apps work, but missing APIs and broken apps should be expected. A public AppDB tracks test results with Gold/Silver/Bronze ratings, starting from simple apps such as a weather viewer and calculator.
Run it locally
You need a recent stable Rust toolchain plus native C/C++ build tools. On macOS install Xcode Command Line Tools; on Linux also install pkg-config and the FreeType/Fontconfig development packages, and run under an X11 or Wayland session.
git clone https://github.com/sohzm/winedroid.git
cd winedroid
cargo build --release --locked --bin winedroid
./target/release/winedroid /path/to/app.apk
App data is stored in ~/.winedroid/default; set WINEDROID_PREFIX to choose another directory. Package management, display settings and profiling are described in the usage guide. If you only want to try it, the hosted browser demo lets you pick or drop an APK without building anything.
Run in the browser
With Emscripten's emcc on your PATH and Python 3 installed, build the WebAssembly version and serve it locally:
rustup target add wasm32-unknown-emscripten
scripts/build_web.sh
python3 -m http.server 4173 --directory web
Then open http://localhost:4173 and load an APK. App data is discarded on reload. This build does not support Android native .so libraries or the Cranelift JIT.
Limits and behavior
Execution is best-effort by default: when a guest call reaches an explicitly unsupported primitive, the runtime prints FIXME and substitutes void, numeric zero, or null by return type. Output after such substitution does not prove compatibility, and missing objects can trigger later failures. Use WINEDROID_STRICT=1 to stop on missing support, or WINEDROID_MISSING_PRIMITIVE_LOG to keep a report of unimplemented primitives. --trace (or WINEDROID_TRACE) enables startup, UI, interaction, automation and missing-call traces.
Compatibility is inherently app-specific: many Android APIs are unimplemented, and the browser build loses native-library support. The code is licensed GPLv3 only, with third-party notices kept separately.
HotRepo's take
HotRepo recorded winedroid at 100 stars and 4 forks during its first tracked day on the new-project list (2026-11-21), following a growth window that began the previous evening. That is a single early snapshot rather than evidence of sustained traction, and it is consistent with a freshly announced experimental runtime. The more useful signal for readers is the project's own honesty about scope: a shared Rust runtime across desktop JIT and browser interpreter, paired with per-app compatibility reports, makes the current state easy to evaluate before committing to a build.
Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.
You might also like
- reveny/Android-Compatibility-LayerRun Android APKs directly on Wayland Linux without a full Android container, aimed at desktop gamers and tinkerers.
- wukongdaily/boxadbA web-based ADB assistant for installing APKs, running a terminal, remote control, screenshots and reboot on Android TV boxes over LAN.
- unixzii/ChampagneRuns Snow Leopard apps like TextEdit as ordinary desktop windows on macOS and Windows, without a virtual machine.
- Leviidev/HuskRuns Android apps and games on iPhone via a native translation layer, QEMU emulation, or PS4 package loading.
- hoangsvit/google-aiA Windows/macOS terminal toolkit that inspects Google AI Pro offers in Google Play via Android, ADB and Frida.