Table of Contents
Overview
QuickADB is a portable GUI wrapper for ADB and Fastboot that eliminates the need to memorize or type commands manually. With its powerful features, you can tweak many settings and change any files on your device without typing a single line. Whether you are a beginner or an experienced developer, QuickADB makes ADB workflows a lot faster and simpler.
QuickADB has been completely rebuilt. To see the old changelog, view README_OLD.
Screenshots
(Single-picture showcase of almost every UI window of QuickADB.)
| Platform |
Supported |
Notes |
| Windows |
Yes ✅ (X86_64, ARM64) |
Primary target (⚠️ARM64 variant doesn’t support payload-dumper-go) |
| Linux |
Yes ✅ (X86_64, ARM64) |
Built on Ubuntu 22.04, may not work on older distros |
| macOS |
Yes ✅ (X86_64, ARM64) |
All functions work as expected as per user feedback |
The latest source is built into executables for all three platforms.
Requirements
- Python 3.10 or higher (Only for building, executables work out of the box)
- USB debugging enabled on the target device
- (For root features) A rooted device with
su access
Installation
Prebuilt Release
- Download the latest release for your OS from the Releases page.
- Run the executable.
Building from Source
# Clone the repository
git clone https://github.com/codefl0w/QuickADB.git
cd QuickADB
# Install dependencies
pip install -r requirements.txt
# Build standalone executable
python build.py # (auto-downloads platform-tools and payload-dumper-go and builds AppImage on Linux. Recommended)
# or
pyinstaller QuickADB.spec # You must provide the platform-tools at the root of the project for commands to work, see developer.android.com/tools/releases/platform-tools#downloads
Output binary will be located in dist/.
Usage
- Connect your Android device via USB.
- Enable USB Debugging in Developer Options.
- Launch QuickADB.
- Authorize your device’s ADB connection by accepting the pop-up on your device (first connection only).
For wireless ADB, use the corresponding button in the ADB section of the tool.
Features
ADB
Execute the most common ADB commands with a single click: reboot options, wireless ADB pairing via QR or pairing code, sideloading, and more.
Fastboot
Execute the most common Fastboot commands with a single click: reboot options, fetching device variables, flashing images, and more.
Terminal
A custom terminal with autocomplete support. Search for keywords in output, export the output to a .txt file, kill running processes, drag-and-drop files, and navigate command history with arrow keys.
Advanced
- Magisk Manager - Download Magisk and patch your boot image with a single button click to root your phone easier. Install/disable/enable modules without ever touching your phone.
- App Manager - Browse all installed apps. Uninstall, disable, view details, modify permissions, backup and restore APKs, and create or apply debloat presets.
- File Explorer - Browse the full device filesystem. Create, rename, delete, copy, paste, pull and push files, manage
chmod permissions, preview images, edit text files, execute shell scripts, and manage root directories.
- GSI Flasher - Detects device state and automatically flashes a GSI ROM, removing unneeded dynamic partitions on demand, without requiring a single manual command.
- Partition Manager - View device partitions, create backups, and flash partition images while the device is powered. (Requires root)
- Super.img Dumper - Extract individual partitions from a
super.img file. Powered by unsuper.
- Payload.bin Dumper - Extract individual partitions from a
payload.bin file. Powered by ssut’s payload-dumper-go.
Miscellaneous
- Device Specifications - View RAM, storage, Android version, root method, and more at a glance.
- Boot Animation Creator - View, back up, and modify your boot animation. Create a new animation from a GIF or video and flash it, or package it as a Magisk module.
- App Market - Automatically download and install apps on your phone from F-Droid. Supports custom repositories.
Boot animation creator requires FFmpeg to run. Please see FFmpeg.md.
Giving Root Permissions
Features that require root access are marked with a # icon within the application. No root is required for standard ADB and Fastboot operations.
For root operations to work, you must grant root access to com.android.shell on your device.
Changing themes
QuickADB has 4 Qt stylesheets included. Simply click the “About” button on the bottom left corner and change your theme.
If you’re building from source, you can add as much .qss themes in the themes/ directory as you want.
Dark - Default theme of QuickADB. Uses a dark navy color palette along with light blue accents.
High Contrast - Darker version of the main theme.
Light - Modern, elegant white theme.
Android - Dark gray color palette with the classic Android green for the accents.
Default - Resets widget styles, forcing them to inherit the OS’ design language instead.
Changelog
See CHANGELOG.md for the full version history.
For the legacy changelog (pre-rebuild), see README_OLD.
Contributing
Contributions are welcome. Please open an issue before submitting a pull request for non-trivial changes.
1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes
4. Open a pull request against main
Please follow the existing code style and make sure the code runs on at least one platform.
Credits
-
payload-dumper-go by ssut - payload.bin extraction
-
SDK Platform Tools by Google - ADB and fastboot binaries
-
PyQt6 by Riverbank Computing - Python adaptation of Qt6
-
Magisk by topjohnwu - Magisk internals & logo
-
All beta testers - Bug detection and improvement suggestions
Donate
If QuickADB has been useful to you, please consider supporting its development via Buy Me a Coffee or GitHub Sponsors.
License
This project is licensed under the GNU General Public License v3.0.
评论