About Winedroid

What is Winedroid?

Winedroid is an Android userspace compatibility layer for macOS and Linux. Instead of booting a full Android system image or running a virtual machine, it translates Android framework calls into host-native equivalents on-the-fly. An APK runs as a first-class desktop application without knowing it is inside Winedroid.

This is not a VM, an emulator, or a container. There is no Android system running underneath — just a runtime that gives an APK what it needs to launch and behave correctly.

Why does this exist?

Android is nominally open-source, but in practice Google controls the runtime, the app distribution, and the device certification process. Running an Android app outside a Google-sanctioned environment is either heavily restricted or requires dragging along gigabytes of Google infrastructure just to launch an APK.

With Google's recent moves tightening their grip on Android, I no longer feel comfortable relying on their ecosystem. Winedroid started as a personal answer to that. If you share the concern, Keep Android Open is worth a read.

Winedroid breaks that dependency. Run the app, not the ecosystem: no Play Services, no Google account, no Android OS.

Open source and community driven

Winedroid is a volunteer project. There is no company behind it, no commercial version, and no roadmap driven by revenue.

Contributions are welcome in any form: bug reports, compatibility testing via the AppDB, and code on GitHub.

AI usage disclosure

This project uses AI heavily — for writing code, automating tests, and for the docs and this website.

Contributors can obviously use AI too. But "hey Cursor, add xyz and open a PR" is not a contribution. If you send a PR, you own it: read the code, test it, and check that the AI actually did what you asked.

If you dump a 3,000-line PR you never read, and thirty other people do the same, I can't review any of it. That wastes your time, my time, and the tokens. Take responsibility for what you submit.

Rating system

The Winedroid AppDB rates app compatibility using the following scale. Ratings reflect the experience on the most recently tested Winedroid version.

RatingMeaning
Platinum Installs and runs out of the box; indistinguishable from native.
Gold Fully usable, but needs a workaround or has cosmetic glitches.
Silver Main use case works reliably; some secondary features broken or slightly degraded.
Bronze Core task is possible, but severe lag, glitches, or mostly broken features make everyday use frustrating.
Garbage Won't install, won't launch, crashes immediately, or opens but is effectively unusable.

License

Winedroid is free and open-source software, licensed under the GNU General Public License v3.0. See the GitHub repository for details.