ADB diagnostics tool with PyQt5 GUI

ADB PRO is a PyQt5 desktop application for managing Android devices via ADB (Android Debug Bridge). This repository contains the application script and packaging instructions for Windows.

Features

• Deep device diagnostics (identity, CPU, RAM, storage, battery, sensors)
• Screenshot and screen recording
• Pull/push files, install/uninstall APKs
• Quick device info and live logcat
• Full backup and factory reset utilities

Prerequisites

• Windows or Linux with Python 3.8+ (this workspace used Python 3.12)
• A Python virtual environment is recommended
• adb must be available in PATH for device operations

Recommended Python packages

Install into your virtual environment:

python -m pip install --upgrade pip
python -m pip install PyQt5 pyinstaller pillow

Run during development

Activate your venv and run the script directly:

.\venv\Scripts\Activate.ps1
python ADB_PRO.py

If you see plugin messages about Qt platforms, that's normal; the app should open a window.

Build a single-file Windows EXE

Use PyInstaller with an .ico icon file. Example:

# from project root
.\venv\Scripts\pyinstaller.exe --clean --onefile --windowed --name "ADB_PRO" --icon "icons8-android-24.ico" .\ADB_PRO.py

• If your icon is PNG, either convert it to .ico first or install pillow so PyInstaller can convert it.
• To debug startup crashes run PyInstaller with --console and --log-level DEBUG and run the generated EXE from a console:

.\venv\Scripts\pyinstaller.exe --clean --onefile --console --log-level DEBUG --name "ADB_PRO_debug" --icon "icons8-android-24.ico" .\ADB_PRO.py
.\dist\ADB_PRO_debug.exe

Troubleshooting

• EXE opens a console when clicking buttons: the app previously launched child adb processes without hiding the console. This repository's run_cmd() uses subprocess.CREATE_NO_WINDOW on Windows to avoid visible child terminals — rebuild after pulling latest changes.
• Icon error about PNG format: install pillow or convert PNG → ICO before passing to --icon.
• If the GUI closes immediately after start, rebuild with --console and inspect the printed traceback or Qt plugin messages.

Notes

• The packaged EXE bundles Qt platform plugins; keep antivirus or Windows Defender from blocking the temporary extraction if the app fails to start.

---

Updated: 2026-06-13