0
Fork 0
mirror of https://github.com/Droid-VM/DroidVM.git synced 2026-11-17 06:58:15 +00:00
Run virtual machine on Android Phones
  • Java 96%
  • C 1.4%
  • C++ 1.2%
  • Python 0.5%
  • HTML 0.3%
  • Other 0.6%
Find a file
lateautumn233 fce41b04aa feat(settings): use shared defaults behind existing App controls
Connect settings, VM starts, disk operations and serial configuration to daemon-owned state while retaining existing names and categories. Hide normal shared-storage status rows.
History 2026-10-19 17:51:25 +08:00
.github Add custom sponsorship URL to FUNDING.yml 2026-09-21 12:48:03 +08:00
app feat(settings): use shared defaults behind existing App controls 2026-10-19 17:51:25 +08:00
contracts/webui build(webui): package frontend and native web transport in APK 2026-10-19 17:50:52 +08:00
daemon@9c3d2656fc build(webui): package frontend and native web transport in APK 2026-10-19 17:50:52 +08:00
gradle build(webui): package frontend and native web transport in APK 2026-10-19 17:50:52 +08:00
migration-tests refactor: remove the Java daemon 2026-10-17 19:03:10 +08:00
scripts build(webui): package frontend and native web transport in APK 2026-10-19 17:50:52 +08:00
webui@53f376a541 build(webui): package frontend and native web transport in APK 2026-10-19 17:50:52 +08:00
.gitattributes Initial commit 2026-04-10 22:29:52 +08:00
.gitignore ci: three source checks, and a build that can unit-test a class that logs 2026-09-01 20:28:18 +08:00
.gitmodules chore(webui): register frontend as a submodule 2026-10-19 12:31:12 +08:00
ADDITIONAL-PERMISSIONS licensing: say the GPLv3 out loud, and allow an upstream relicense 2026-09-01 20:28:17 +08:00
build.gradle.kts Initial commit 2026-04-10 22:29:52 +08:00
build.sh build: skip prebuilts submodule checkout in local build flow 2026-06-27 21:58:24 +08:00
CONTRIBUTING.md licensing: say the GPLv3 out loud, and allow an upstream relicense 2026-09-01 20:28:17 +08:00
gradle.properties Initial commit 2026-04-10 22:29:52 +08:00
gradlew CI: Add workflows build and release 2026-04-11 20:23:21 +08:00
gradlew.bat Initial commit 2026-04-10 22:29:52 +08:00
icon.svg Initial commit 2026-04-10 22:29:52 +08:00
LICENSE.txt Initial commit 2026-04-10 22:29:52 +08:00
LICENSING.md licensing: say the GPLv3 out loud, and allow an upstream relicense 2026-09-01 20:28:17 +08:00
README.md README.md: add GenieZone and KVM 2026-06-27 15:22:18 +08:00
README.zh.md README.md: add GenieZone and KVM 2026-06-27 15:22:18 +08:00
settings.gradle.kts test(migration): run protocol contracts in an isolated Android package 2026-10-16 00:02:16 +08:00

DroidVM

DroidVM Logo

简体中文 | English

An Android virtual machine manager with support for multiple hypervisors, including Qualcomm Gunyah, MediaTek GenieZone, and Linux KVM.

Supported hypervisors:

  • Qualcomm Gunyah (/dev/gunyah)
  • MediaTek GenieZone (/dev/gzvm)
  • Linux KVM (/dev/kvm)

Create and manage lightweight VMs directly on your device with near-native performance.

Resources

Features

  • Multiple VM backend support: crosvm and QEMU
  • UEFI boot for Linux or Windows
  • GPU acceleration: VirGL, GfxStream, and 2D software rendering
  • Built-in VNC client for graphical display access
  • External display casting: cast VM display to an external screen (USB Type-C, Miracast, etc.) via Android Presentation API, with the phone acting as a touchpad controller
  • Terminal console with full ANSI/xterm emulation (via Termux terminal libraries)
  • Create and edit disk images in multiple formats: raw, qcow2, and more
  • Disk operations: resize, convert, clone, optimize, and delete
  • Disk/CD-ROM download and LXC image import support
  • Virtual bridge networks with NAT, DHCP, STP, and IPv4/IPv6 support
  • Shared directories between host and guest via VirtFS (9p)
  • Windows support with modified VirtIO drivers
  • Linux agent operations: change password, etc.

Requirements

  • Android 13 (API 33) or newer
  • Root access (Magisk, KernelSU, APatch, or similar)
  • A supported ARM64 device with hardware virtualization enabled by firmware and kernel:
    • Qualcomm: Snapdragon 8 Gen 3 (SM8650) or newer SoC, Snapdragon 8 Elite (SM8750) recommended, with Gunyah enabled
    • MediaTek: Dimensity 9000 or newer SoC with GenieZone enabled
    • Other ARM64 devices: booted with EL2 and Linux KVM enabled
  • An available virtualization device node: /dev/gunyah, /dev/gzvm, or /dev/kvm

Building

Prerequisites

Steps

git clone https://github.com/Droid-VM/DroidVM.git
cd DroidVM
git submodule update --init --recursive
./gradlew assembleRelease

The built APK will be located at app/release/.

License

This project is licensed under the GNU General Public License v3.0. See LICENSE.txt for details.