MCPcopy Index your code
hub / github.com/Drenzzz/ADBKit

github.com/Drenzzz/ADBKit @v1.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.3 ↗ · + Follow
432 symbols 876 edges 82 files 6 documented · 1% 8 cross-repo links
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ADBKit

A simple, modern GUI for ADB and Fastboot — built with Wails (Go + React) for speed, lightweight resource usage, and native performance.


Features

Dashboard & Devices - Unified device list with editable nicknames - Global selected device context synced across modules - Rich device info: battery, storage, RAM, root status, connection state - Wireless ADB toggle and pairing via IP/Port

Device Monitoring - Live CPU, RAM, and network usage tracking - In-app monitoring without switching to external tools

App Manager - Virtualized lists for smooth handling of thousands of packages - Batch install, uninstall, enable, and disable - Install local APKs or pull APKs from device - Filter by User/System apps, sort by name or state

File Explorer - Push, Pull, Rename, Delete, and Create Folders - Unlimited timeout for large file transfers - Retry support and clear batch result reporting - Concurrent I/O with virtualized directory rendering

Logcat & Observability - Real-time Logcat streaming with filter support - Internal command log history across modules

Fastboot & Flashing - Direct adb and fastboot shell access - One-click reboot to System, Recovery, or Bootloader - Flash images, ZIPs, and folder-based image sets - Slot A/B management and targeted partition flashing

Reliability & Safety - Strict guards for destructive actions - Validation for flash flows and command execution - Path sanitization for shell-based file operations - Clean resource handling for long-running streams - Modular, service-based backend architecture

Packaging & Distribution - Windows and Linux releases bundle adb and fastboot - Ready-to-use installer and Linux packages


Screenshots

See here


Installation

  1. Go to the Releases page
  2. Download the latest release for your OS
  3. Install or extract the package
  4. Run the application

Note: Official Windows and Linux builds include bundled platform tools. For manual builds, ensure adb and fastboot are available in your environment.


Tech Stack

Layer Technology
Core Wails v2
Backend Go — Modular Service Architecture
Frontend React (via Astro) + TypeScript
State Custom React Hooks + Composition
UI shadcn/ui + Tailwind CSS

Building from Source

Prerequisites: Go 1.21+, Node.js 18+, pnpm

# Install frontend dependencies
cd frontend && pnpm install && cd ..

# Development
wails dev

# Production build
wails build

Troubleshooting

Issue Fix
Device not found Enable USB Debugging; install required drivers
Unauthorized Accept the RSA fingerprint prompt on your device
Wireless ADB not working Ensure device and computer are on the same network
Linux USB access denied Configure udev rules for your device

Contributing

Contributions are welcome — open an issue or submit a pull request.

Repo: https://github.com/Drenzzz/adb-gui-kit


License

MIT

Extension points exported contracts — how you extend this code

Position (Interface)
(no doc)
frontend/wailsjs/runtime/runtime.d.ts
CommandLogTableProps (Interface)
(no doc)
frontend/src/components/logs/CommandLogTable.tsx
Size (Interface)
(no doc)
frontend/wailsjs/runtime/runtime.d.ts
LoadingOverlayProps (Interface)
(no doc)
frontend/src/components/layout/LoadingOverlay.tsx
Screen (Interface)
(no doc)
frontend/wailsjs/runtime/runtime.d.ts
AppSidebarProps (Interface)
(no doc)
frontend/src/components/layout/AppSidebar.tsx
EnvironmentInfo (Interface)
(no doc)
frontend/wailsjs/runtime/runtime.d.ts
ShellTerminalCardProps (Interface)
(no doc)
frontend/src/components/shell/ShellTerminalCard.tsx

Core symbols most depended-on inside this repo

cn
called by 66
frontend/src/lib/utils.ts
runCommand
called by 19
backend/executor.go
logCommand
called by 11
backend/command_log_service.go
runAdbCommand
called by 10
backend/executor.go
runAdbCommandWithSerial
called by 8
backend/executor.go
runCommandContext
called by 7
backend/executor.go
resolveActiveAdbSerial
called by 7
backend/executor.go
validateRemotePath
called by 7
backend/validation_service.go

Shape

Function 272
Method 97
Interface 35
Class 16
Struct 11
TypeAlias 1

Languages

TypeScript75%
Go25%

Modules by API surface

frontend/wailsjs/go/backend/App.js54 symbols
frontend/wailsjs/runtime/runtime.js53 symbols
frontend/wailsjs/go/models.ts33 symbols
frontend/src/components/ui/dropdown-menu.tsx15 symbols
backend/app.go15 symbols
frontend/src/components/views/ViewFlasher.tsx13 symbols
backend/file_service.go13 symbols
frontend/src/components/ui/alert-dialog.tsx11 symbols
frontend/src/components/ui/dialog.tsx10 symbols
backend/package_service.go10 symbols
backend/executor.go10 symbols
backend/dialog_service.go10 symbols

For agents

$ claude mcp add ADBKit \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact