86 lines
3.0 KiB
Markdown
86 lines
3.0 KiB
Markdown
# 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)
|