Skip to content

codefl0w/QuickADB

Repository files navigation

QuickADB Logo

A powerful GUI wrapper for ADB and Fastboot, built for Android developers and power users. Focused on reliability and speed, it provides one-click flows for common device tasks while keeping advanced tools available for power users.

Downloads Stars Platform License Workflow


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.

Note

QuickADB has been completely rebuilt. To see the old changelog, view README_OLD.


Screenshots

showcase_new

(Single-picture showcase of almost every UI window of QuickADB.)


Platform Support

Platform Supported Notes
Windows Yes Primary target
Linux Yes Some libs may mismatch with your distro and cause issues. If so, create an issue
macOS Experimental Darwin systems are supported but untested. Testing and feedback required

The latest source is built into executables for all three platforms.


Requirements

  • Python 3.10 or higher
  • USB debugging enabled on the target device
  • (For root features) A rooted device with su access

Installation

Prebuilt Release

  1. Download the latest release for your OS from the Releases page.
  2. 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

  1. Connect your Android device via USB.
  2. Enable USB Debugging in Developer Options.
  3. Launch QuickADB.
  4. 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

  • ADB App Manager - Browse all installed apps. Uninstall, disable, view details, modify permissions, backup and restore APKs, and create or apply debloat presets.
  • ADB 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.

Note

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


Donate

If QuickADB has been useful to you, please consider supporting its development via Buy Me a Coffee or GitHub Sponsors.

yellow-button

License

This project is licensed under the GNU General Public License v3.0.

Sponsor this project

  •  

Packages

 
 
 

Contributors