README.md

ADM Emulator

Structured Workspace for Android Device Manager, Decompilers and other Reverse Engineering tools.

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.

Submodules

• adm: tango-adb old-demo client (with Frida Support WIP)
• dev-tools: decompilers, shellcode repository
• manager: webapp to manage multiple devices connected to the server
• other packages required for adm

Setup

1. Clone the repo

git clone https://github.com/dev-rvk/ADM-V3
cd ADM-V3

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
npx next export

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

Features

• Device Management: Supports multiple devices connected via adb over wifi to the server, and their access through the tango-adb old-demo app

• Static Analysis

  • Ghidra, Angr Decompilers
  • JadX apk Decompiler

• Dynamic Analysis

  • Run scripts using Frida (WIP)

• Shell Code Repository

• Compile & Deploy shell codes (WIP)

• 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)