ADM Emulator

This project is based on tango-adb/old-demo which gives API Reference for using tango. It uses a subset of features provided by the library to manage and connect to emulators using WebSockets.

Setup

1. Clone the repo

git clone https://github.com/dev-rvk/adm-emulator
cd adm-emulator

2. Install dependancies

pnpm install

3. Run in developement environment

pnpm recursive run build
pnpm recursive run dev                                           

Build

pnpm install
pnpm recursive run build

Generate static build that can be hosted on GitHub Pages

This project was built using Next.js However, since it doesn't have any server-side code, the most simple deployment method is to use the Static HTML Export feature of Next.js. It generates pre-rendered, fully static HTML files, that can be deployed to any static website hosting services (e.g. GitHub Pages).

To export static deployable HTML files, after running rush build command, run:

cd packages/adm-emulator
npx next export

This will create an out folder containing exported HTML files and all required resource files.

Features

• File Management
  • List
  • Upload
  • Download
  • Delete
  • Preview image files
• Screen Capture
• Terminal Emulator powered by Tabby
  • Tabs and split panes
  • Color themes
  • Rich configuration
• Install APK
• Scrcpy compatible client
  • Screen mirroring
  • Audio forwarding (Android >= 11)
  • Recording
  • Control device with mouse, touch and keyboard
• Monitor and dump logcat messages
• Power off and reboot to different modes

Used open-source projects

• ADB from Google (Apache License 2.0)
• Scrcpy from Romain Vimont (Apache License 2.0)
• Tabby from Eugeny (MIT License)
• webm-muxer from Vanilagy (MIT License)
• web-streams-polyfill from Mattias Buelens (MIT License)