# DroidFleet Visor 🤖

Cloud virtualization platform for deploying, managing, and renting Android virtual devices with custom bootloaders, root access, and interactive ADB screen streaming.

## Features

- **VM Fleet Management** — Deploy, start, stop, and monitor Android VMs
- **Custom Bootloaders** — Unlock bootloaders, root with Magisk, custom recovery, SELinux control
- **Screen Streaming** — Real-time VNC/ADB screen viewer with touch interaction
- **Proxy Management** — Per-VM proxy configuration with rotation support
- **App Automation** — Instagram, Gmail, Facebook app views with programmatic control
- **MCP API Studio** — REST API for external tool integration
- **ADB Console** — Direct ADB shell access from the browser
- **Device Profiles** — Pre-configured Pixel, Samsung, OnePlus device templates

## Tech Stack

- **Frontend**: React 19 + TypeScript + TailwindCSS 4 + Vite
- **Backend**: Express + TypeScript
- **Icons**: Lucide React
- **Animations**: Motion (Framer Motion)
- **AI**: Google Generative AI integration

## Quick Start

```bash
# Install dependencies
npm install

# Development (with HMR)
npm run dev

# Production build
npm run build

# Start production server
npm start
```

Server runs on `http://localhost:3000`.

## API Endpoints

| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/api/vms` | List all Android VMs |
| `POST` | `/api/vms` | Deploy a new VM |
| `GET` | `/api/vms/:id` | Get VM details |
| `POST` | `/api/vms/:id/start` | Start a VM |
| `POST` | `/api/vms/:id/stop` | Stop a VM |
| `DELETE` | `/api/vms/:id` | Destroy a VM |
| `GET` | `/api/vms/:id/screen` | Screen stream (WebRTC) |
| `POST` | `/api/vms/:id/adb` | Execute ADB command |
| `GET` | `/api/subscription` | Get subscription status |
| `POST` | `/api/subscription` | Update subscription |

## Architecture

```
┌─────────────────────────────────────┐
│  React Frontend (Vite + Tailwind)   │
│  HypervisorConsole · ScreenViewer   │
│  ProxyManager · McpApi · ADB        │
└──────────────┬──────────────────────┘
               │ REST API
┌──────────────┴──────────────────────┐
│  Express Server (TypeScript)        │
│  In-Memory VM Database             │
│  Subscription Management           │
└──────────────┬──────────────────────┘
               │
┌──────────────┴──────────────────────┐
│  Android VMs (QEMU/KVM)            │
│  Custom bootloaders · Root access  │
│  ADB · VNC · WebRTC streaming      │
└─────────────────────────────────────┘
```

## License

MIT

---

☕ [Buy me a coffee](https://buymeacoffee.com/r26xrthzttg)