A virtual Android phone that runs on your PC, laptop or server.
It starts like a new phone, keeps everything you add, and comes back as you left it.
Quick start · Command reference · Roadmap · Contributing · Security · Changelog
Verone is an open-source virtual Android phone that runs as an application on a PC, laptop or server. Each phone is kept on your computer: switch it off and everything on it is still there the next time you start it.
- One command per job. Create, start, open, stop, reset and delete phones from the terminal.
- Many phones. Keep separate phones for work, testing or anything else, each with its own name, screen size and data.
- Made for developers. Install APK files, get an
adbshell with root access, and script everything with--jsonoutput. - Checks before it fails.
verone doctortests this computer and says how to fix what is missing.
Note
Status: early. Version 0.1 is a command-line tool for Linux. A desktop app, Google apps, encryption and Windows support are planned; see the roadmap.
- Linux on an x86-64 computer, with about 4 GB of free disk space and 2 GB of free memory.
- Docker, with your user in the
dockergroup. - A kernel with binder support. Arch, Fedora and Debian have it; on Ubuntu install
linux-modules-extra-$(uname -r). adb(packageandroid-tools) andscrcpyto see and control the phone.
verone doctor checks all of this and tells you how to fix what is missing.
On Arch Linux, from a checkout of this repository:
cd packaging/arch
makepkg -f
sudo pacman -U verone-*.pkg.tar.zstOn other distributions, with Rust installed:
cargo install --path crates/verone-cliCheck the installation with verone --version.
verone doctor # check that this computer can run phones
verone create work # make a phone called "work"
verone start work # boot it; the first start downloads Android (about 3 GB)
verone open work # show it in a windowWhen you are done:
verone stop work # switch it off; everything on it is keptOther things you can do:
verone list # all phones and whether they are running
verone info work # details about one phone
verone install work app.apk # install an app
verone adb work -- shell # a shell on the phone
verone reset work # erase the phone, keep its settings
verone delete work # remove it completelyThe command reference describes every command and option.
- It is a plain Android 14 system without Google apps. Install apps from APK files or an open app store such as F-Droid.
- The phone has root access through
adb, which suits development and testing. - Apps that demand certified hardware, such as many banking apps, will not run.
Warning
Verone runs Android in a privileged container that shares your computer's kernel. Read SECURITY.md before running software you do not trust in it.
| Read this | To learn |
|---|---|
| Vision and scope | What Verone is and who it is for |
| Command reference | Every command, option and exit code |
| Roadmap | What comes after version 0.1 |
| Architecture | How the pieces fit together |
| All design documentation | Decisions, assumptions and phase plans |
| Brand | The logo, colours and how to use them |
Bug reports, ideas and pull requests are welcome. Read CONTRIBUTING.md for how the project works and how to build and test it, and SECURITY.md for how to report a security problem privately.
Verone is released under the Apache License 2.0; see also NOTICE.