AVF Pro / AVF+

Transforming Android's basic terminal into a persistent, full-featured Linux desktop and development environment.

The Problem

The default Debian terminal introduced in Android 16 via AVF, while promising, is heavily restricted. It lacks persistence, has severe storage limitations, and misses the essential features required for any practical development work.

The Solution

This project overcomes these limitations through deep system analysis, reverse engineering, and advanced Linux techniques. It unlocks AVF's potential to provide a truly usable, powerful, and persistent Linux environment right on your mobile device.

Key Features

Full Linux Desktop

Run standard desktop environments like XFCE4 or GNOME, accessible via any VNC client.

Massive Storage

Overcomes the default disk limit using a robust LVM on `qcow2` solution for ample space.

Development Toolchains

Easily install environments for Python, Node.js, C/C++, Go, Rust, and more.

Seamless Integration

Leverages `virtiofs` for straightforward file sharing between Android and the Linux VM.

AI-Powered Tools ✨

Leverage the Gemini API to enhance your workflow.

AI Command Generator

Describe what you want to do in the terminal, and get the command you need.

Your generated command will appear here...

Project Idea Generator

Not sure what to do with a Linux environment on your phone? Get inspired!

Showcase

Visual demonstrations of AVF Pro+ in action.

Gnome Desktop over VNC
Run standard graphical Linux applications.
Python installer in terminal
Fully featured interactive python installer transforms the terminal experience
Gemini AI integration
Gemini-cli enables ai agents to assist and automate terminal workflows.
Local AI Display
A complete mobile ai development powerhouse.

Technical Highlights

This project required navigating a highly undocumented and evolving Android feature. It demonstrates full-stack problem-solving across the Android host, AVF framework, `crosvm` hypervisor, Linux kernel, and Debian guest OS.

Key Accomplishments

  • Deep AVF Analysis: Reverse-engineered the VM boot process and `vm_config.json` behavior without official documentation.
  • Hypervisor Interaction: Captured and analyzed low-level `crosvm` commands to understand secure resource provisioning.
  • Novel Storage Solution: Designed and implemented a complex but reliable method to attach and manage large `qcow2` disk images with LVM.
  • Robust Automation: Developed comprehensive shell scripts and custom `systemd` services for automated setup and reliable operation.

The Future: A Dedicated App

Manually replicating this environment is highly complex. To provide a streamlined and reliable experience for all users, a dedicated Android application is in development.

The app will handle the complex setup, provide the necessary pre-configured components, and manage the environment, making the power of a full Linux desktop on Android accessible to everyone.

Contact & Collaboration

I am actively seeking collaboration and am open to new opportunities. If this project interests you, let's connect.

Connect on LinkedIn

Stay Updated & Collaborate

Join the mailing list to get updates on the project and learn about collaboration opportunities.