Skip to content

kil0bit-kb/kb-android-emulator

Repository files navigation

KB Android Emulator Manager

A modern, standalone desktop application built with React and Tauri v2 to manage, configure, and optimize Android Virtual Devices (AVDs).

It features advanced auto-tuning, system resource clamping, graphics pipeline selection, and recovery tools to deliver a high-performance, developer-friendly emulator management experience.


Core Features

  • Premium Dark Interface: A sleek, fully responsive dashboard built with custom glassmorphism components, detailed system resource monitors, and real-time log consoles.
  • GPU Accelerator Configuration: Native dropdown controls to toggle between Gfxstream (auto), Hardware Passthrough (host), and CPU fallback (software) rendering pipelines.
  • Smart OS Auto-Tuning: Dynamic configuration locks for specialized system images:
    • Wear OS Watches: Locks resources to 1GB RAM / 1 Core, sets a 128MB Dalvik heap, and strips conflicting resolution properties to guarantee circular watch face layouts boot stably.
    • Android TV: Locks resources to 2GB RAM / 2 Cores and tunes Dalvik heap size.
    • Android Automotive: Locks resources to 4GB RAM / 4 Cores for optimal dashboard UI emulation.
  • Wipe & Boot Recovery: A one-click diagnostic tool that launches the emulator with the -wipe-data flag to wipe corrupted Quick Boot snapshots and reset user space storage, instantly resolving boot loops.
  • Ahead-Of-Time (AOT) compiler optimizer: Compile all user-installed guest applications directly to native machine code via ADB (cmd package compile -m speed) for up to 40% performance gains.
  • Network Acceleration: Bypasses slirp DNS latencies by routing emulator traffic through Cloudflare's public resolver (1.1.1.1) and tunes QEMU TCP write window buffers on launch.

Getting Started

Prerequisites

Ensure you have the following installed on your machine:

  • Node.js (LTS version recommended)
  • Rust Toolchain (via rustup)
  • Android SDK (with command-line tools and system-images configured)
  • Windows Hypervisor Platform (WHPX) or HAXM active in Windows Features.

Installation

  1. Clone the repository:

    git clone https://github.com/kil0bit-kb/kb-android-emulator-manager.git
    cd kb-android-emulator-manager
  2. Install dependencies:

    npm install
  3. Configure environment: The application will automatically detect your local Android SDK located in your user profile path or look for a local android-sdk/ folder inside the app directory.


Running & Building

Run Development server

Launches the hot-reloading Vite dev server and spawns the Tauri native Windows desktop container:

npm run tauri dev

Build Production installer

Compiles frontend assets, builds the Rust launcher backend, and generates a standalone Windows .msi or .exe installer bundle in src-tauri/target/release/bundle/:

npm run tauri build

Project Structure

├── src/                  # React Frontend UI
│   ├── components/       # UI Components (Devices, GPU cards, Logs, etc.)
│   ├── App.jsx           # Main Shell Layout
│   └── index.css         # Custom Premium CSS Design System
├── src-tauri/            # Rust Backend Launcher
│   ├── src/
│   │   ├── commands.rs   # Core commands (AVD configuration, ADB, compiler opts)
│   │   └── main.rs       # Entrypoint & Tauri system shell configuration
│   └── Cargo.toml        # Rust package manifest
└── package.json          # Node dependencies and scripts

About

A standalone, high-performance Android Emulator Manager built with React and Tauri v2. Features GPU auto-tuning, smart TV/Watch resource clamping, Wipe & Boot recovery, and AOT compilation.

Topics

Resources

License

Stars

92 stars

Watchers

3 watching

Forks

Packages

 
 
 

Contributors