Skip to content
AxoineoPublic

About

Verone is a virtual android phone that can run on your laptop, PC and server

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Verone

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.

CI status Latest release Licence: Apache-2.0 Rust 1.99 or newer Android 14 Platform: Linux x86-64

Quick start · Command reference · Roadmap · Contributing · Security · Changelog


About

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 adb shell with root access, and script everything with --json output.
  • Checks before it fails. verone doctor tests 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.

What you need

  • 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 docker group.
  • A kernel with binder support. Arch, Fedora and Debian have it; on Ubuntu install linux-modules-extra-$(uname -r).
  • adb (package android-tools) and scrcpy to see and control the phone.

verone doctor checks all of this and tells you how to fix what is missing.

Install

On Arch Linux, from a checkout of this repository:

cd packaging/arch
makepkg -f
sudo pacman -U verone-*.pkg.tar.zst

On other distributions, with Rust installed:

cargo install --path crates/verone-cli

Check the installation with verone --version.

Quick start

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 window

When you are done:

verone stop work         # switch it off; everything on it is kept

Other 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 completely

The command reference describes every command and option.

What to expect

  • 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.

Documentation

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

Contributing

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.

Licence

Verone is released under the Apache License 2.0; see also NOTICE.

About

Verone is a virtual android phone that can run on your laptop, PC and server

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages