ADBKit

ADBKit

A desktop toolkit for Android device work with ADB, Fastboot, and scrcpy.

Features | Platforms | Installation | Screenshots | Development | Troubleshooting | Contributing

ADBKit puts device management, app and file operations, terminal, logcat, flashing, scrcpy controls, and binary setup in one desktop app. The setup wizard can find installed tools, use paths you provide, or download managed packages. ADB, Fastboot, and scrcpy must all be ready before setup can finish.

Features

Dashboard and devices

• Select and switch between connected devices.
• View device details, battery, storage, RAM, connection state, and performance.
• Connect over USB or wireless ADB, including the wireless pairing flow.
• Edit device nicknames, take screenshots, detect device modes, and run reboot actions.

App manager

• Browse installed packages in a virtualized list.
• Install APKs from a picker or drag and drop them into the app.
• Uninstall, enable, disable, clear data, and run batch actions.
• Pull APK files and inspect package details with search, filtering, and sorting.

File explorer

• Browse device storage with breadcrumbs and hidden-file support.
• Push, pull, create, rename, and delete files or folders.
• See transfer progress and cancel an active transfer.
• View storage usage and jump to mounted external SD cards.
• Get clear guidance when Android blocks a protected or unavailable path.

Flasher

• Flash individual partitions after validating the target name.
• Scan a ROM folder and review its Flash Plan before writing images.
• Manage A/B slots and use the wipe-data confirmation guardrail.
• Send ZIP files through ADB sideload and run validated Fastboot commands.
• Use Wake on Fastboot actions for continue, wake, unlock, and stay-awake flows.

Terminal and Logcat

• Use ADB shell, ADB host, and Fastboot host modes.
• Keep command history and session output in the app.
• Stream Logcat and filter by level, tag, or text.
• Export Logcat output to a file.

Scrcpy

• Start screen mirroring in a native window.
• Record the device screen with a timer and file-size estimate.
• Capture screenshots and save them to the host.
• Synchronize the clipboard between the device and computer.
• Adjust resolution, FPS, bitrate, codec, audio, rotation, and saved presets.

Setup, settings, and diagnostics

• Detect binaries in saved configuration, the system PATH, managed packages, and common paths.
• Select custom files or directories for ADB, Fastboot, and scrcpy.
• Download and preserve complete Platform Tools and scrcpy packages.
• Switch between dark and light themes and set terminal defaults.
• Persist window state and configure the device synchronization interval.
• Review optional audit logs and runtime diagnostics.

Supported platforms

Platform	Requirements	Distribution
Linux	GTK4 and WebKitGTK 6	AppImage, DEB, RPM, and Arch packages
Windows 10 and later	Microsoft WebView2 Runtime	Portable executable and Wails packaging tasks
macOS 12 and later	Platform-specific WebKit support	Build configuration is included; no macOS release artifact is currently published

Windows 7 is not supported by the v2 application. The Linux appimage target bundles more dependencies for portability. The appimage-lite target expects the host system to provide GTK4, WebKitGTK 6, and their runtime dependencies.

Installation

Download the package for your platform from the ADBKit releases page, or browse the ADBKit website for release stats.

Linux

For an AppImage:

chmod +x ./ADBKit-<version>-linux-amd64.AppImage
./ADBKit-<version>-linux-amd64.AppImage

Package managers can install the files produced for their format:

sudo apt install ./<deb-file>
sudo dnf install ./<rpm-file>
sudo pacman -U ./<arch-package>

Windows

Run the downloaded .exe. Windows 11 normally includes WebView2. On Windows 10 or managed machines, install the Evergreen WebView2 Runtime if ADBKit does not start.

First launch

The setup wizard checks for ADB, Fastboot, and scrcpy. It can use an existing installation, accept a custom path, or download a managed package. The managed packages keep the supporting files required by ADB, Fastboot, and scrcpy, such as lib64/ and scrcpy-server.

Screenshots

Screenshots for the dashboard, devices, app manager, File Explorer, Flasher, Terminal, Scrcpy, and Settings are in here.

Development

Requirements

• Go 1.25 or later
• Bun
• Wails v3 CLI
• Platform dependencies required by Wails and the target operating system

The repository currently uses Wails v3.0.0-beta.9.

Clone the repository and install dependencies:

git clone https://github.com/Drenzzz/ADBKit.git
cd ADBKit
go mod download
cd frontend
bun install
cd ..

Run the app with hot reload:

wails3 dev

Build a production executable. The output is written to bin/:

wails3 build

Run the checks used by the project:

make check
make check-all
go test ./...

Package the current platform:

wails3 package

Linux package targets are also available through the Makefile:

make deb rpm arch appimage
make appimage-lite

After changing an exported Go service, regenerate the TypeScript bindings:

wails3 generate bindings -clean -ts

Generated bindings live in frontend/bindings/. Do not edit those files by hand.

Project layout

• main.go contains the Wails application shell and window setup.
• internal/ contains domain services and process integrations.
• internal/app/ exposes the service facade used by Wails.
• frontend/src/ contains routes, components, stores, hooks, and service adapters.
• frontend/bindings/ contains generated TypeScript bindings.
• build/ contains Wails build, icon, and packaging assets.

Troubleshooting

Symptom	Check
Device not found	Enable USB debugging and install the required USB driver.
Device is unauthorized	Accept the RSA prompt on the device.
Wireless ADB fails	Check the network connection, pairing state, and port.
Linux USB access is denied	Configure a udev rule for the device vendor.
Windows app does not open	Install or repair Microsoft WebView2 Runtime.
Scrcpy exits immediately	Confirm that scrcpy-server exists in the managed package.
Setup cannot finish	Make sure ADB, Fastboot, and scrcpy are all ready.
Flashing fails	Check Fastboot mode and validate the partition name.

Star History

Contributing

Open an issue for a bug or feature request. Before opening a pull request, read the contribution guide. Pull requests that change behavior should include tests for the affected path and pass make check.

Report security vulnerabilities privately using the process in SECURITY.md, not through a public issue.

License

ADBKit is available under the MIT License.