FadADB is a modern, user-friendly tool for managing Android devices over ADB, supporting both USB and wireless connections. It features a CLI and a beautiful cross-platform GUI, making it easy to connect, manage, and troubleshoot your Android devices for development, debugging, and automation.
FadADB comes in both a modern GUI and a fast CLI version:
FadADB GUI: Manage, connect, and test Android devices with a modern interface.
FadADB GUI: Additional features and device management tools.
FadADB CLI: Fast, clear, and color-coded device management from the terminal.
- Connect to Android devices via USB or WiFi (wireless ADB)
- Automatic detection and wireless connection: Plug in via USB, enable wireless debugging, and FadADB will auto-connect wirelessly and remember your device
- Manual add by IP: Add and connect to devices by IP address (no USB needed if you know the IP)
- Auto-reconnect: Remembers wireless devices and reconnects after ADB server restarts
- Device list and status: See all connected devices, with clear USB/WiFi icons
- Test device: Instantly check if a device is reachable and responsive
- ADB server management: Restart the ADB server from the GUI or CLI
- View and manage saved wireless devices
- Cross-platform: Works on Windows and Linux
- Download the latest installer from the Releases page.
- Run the installer and follow the prompts.
- Launch FadADB from the Start Menu or Desktop shortcut.
-
Install Python 3.11+ (or newer)
-
Install requirements:
pip install -r requirements.txt # or manually: pip install pyqt6 colorama -
Run:
python FadADB.py
Run:
python FadADB.pyOr launch the FadADB.exe if using the packaged version.
Main Menu Options:
- Connect device
- Show connected devices
- Launch GUI
- Restart ADB Server
- Add device by IP (manual)
- Exit
- Launch from the CLI menu or directly run
FadADB.exe(orpython FadADB.py --gui) - Features:
- Device list with connect/test/refresh
- Add device by IP (with example placeholder)
- View saved wireless devices (shows the path and JSON content)
- Restart ADB server from the GUI
- All logs and actions are shown in the interface
- Plug in your device via USB and enable wireless debugging in developer options
- FadADB will detect the device, fetch its IP, and connect wirelessly
- Once connected, you can unplug USB and manage the device wirelessly
- FadADB remembers your device's IP for future auto-reconnects
- You can also manually add a device by IP if you know it
Note: If your device's IP changes or wireless debugging is disabled, you may need to reconnect via USB to re-enable wireless ADB.
- FadADB stores known wireless device IPs in
fadadb_state.json(created next to the exe or script) - You can view and manage this file from the GUI
- This file is ignored by git and not bundled in the installer
- Build a standalone exe with:
pyinstaller FadADB.spec
- The output will be in
dist/FadADB/
- Python 3.11+
- PyQt6
- colorama
- adb (Android Debug Bridge) must be in your PATH
GPLv3
Pull requests and suggestions are welcome!