{"id":28426385,"url":"https://github.com/anonfaded/fadadb","last_synced_at":"2026-05-04T01:34:35.081Z","repository":{"id":292460967,"uuid":"980967722","full_name":"anonfaded/FadADB","owner":"anonfaded","description":"ADB Manager for USB and Wireless Devices for development, debugging, and automation.","archived":false,"fork":false,"pushed_at":"2025-09-04T02:06:06.000Z","size":13364,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-04T04:21:07.742Z","etag":null,"topics":["adb","android-debug-bridge","linux","python3","qt6","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anonfaded.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-10T03:49:37.000Z","updated_at":"2025-09-04T02:06:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"e0459f41-fe41-457f-986b-82c197538d4d","html_url":"https://github.com/anonfaded/FadADB","commit_stats":null,"previous_names":["anonfaded/fadadb"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/anonfaded/FadADB","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anonfaded%2FFadADB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anonfaded%2FFadADB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anonfaded%2FFadADB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anonfaded%2FFadADB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anonfaded","download_url":"https://codeload.github.com/anonfaded/FadADB/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anonfaded%2FFadADB/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32591601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"ssl_error","status_checked_at":"2026-05-03T22:09:10.534Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adb","android-debug-bridge","linux","python3","qt6","windows"],"created_at":"2025-06-05T11:10:17.433Z","updated_at":"2026-05-04T01:34:35.066Z","avatar_url":"https://github.com/anonfaded.png","language":"Python","funding_links":["https://ko-fi.com/D1D510FNSV","https://ko-fi.com/D1D510FNSV'"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/img/FadADB-png.png\" alt=\"FadADB Icon\" width=\"220\" /\u003e\n\n\n# **FadADB - ADB Manager for USB and Wireless Devices**\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\nFadADB 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.\n\n\u003cbr\u003e\n\n[![GitHub all releases](https://img.shields.io/github/downloads/anonfaded/FadADB/total?label=Downloads\u0026logo=github)](https://github.com/anonfaded/FadADB/releases/)\n\n[![ko-fi badge](https://img.shields.io/badge/buy_me_a-coffee-red)](https://ko-fi.com/D1D510FNSV)\n[![Discord](https://img.shields.io/discord/1263384048194027520?label=Join%20Us%20on%20Discord\u0026logo=discord)](https://discord.gg/kvAZvdkuuN )\n\n\n\n\n\u003cbr\u003e\n\n| :exclamation: | This project is part of the [FadSec Lab suite](https://github.com/fadsec-lab). \u003cbr\u003e Discover our focus on ad-free, privacy-first applications and stay updated on future releases!  |\n|---------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/bornmay/bornmay/Update/svg/Bottom.svg\" alt=\"Github Stats\" /\u003e\n\u003c/p\u003e\n\n\n---\n\n## Screenshots\n\n**FadADB comes in both a modern GUI and a fast CLI version:**\n\n![FadADB GUI](assets/img/screenshots/gui.png)\n*FadADB GUI: Manage, connect, and test Android devices with a modern interface.*\n\n![FadADB GUI - More Features](assets/img/screenshots/gui2.png)\n*FadADB GUI: ADB options.*\n\n![FadADB CLI](assets/img/screenshots/cli.png)\n*FadADB CLI: Fast, clear, and color-coded device management from the terminal.*\n\n---\n\n## Features\n\n- **Connect to Android devices via USB or WiFi (wireless ADB)**\n- **Automatic detection and wireless connection**: Plug in via USB, enable wireless debugging, and FadADB will auto-connect wirelessly and remember your device\n- **Manual add by IP**: Add and connect to devices by IP address (no USB needed if you know the IP)\n- **Auto-reconnect**: Remembers wireless devices and reconnects after ADB server restarts\n- **Device list and status**: See all connected devices, with clear USB/WiFi icons\n- **Test device**: Instantly check if a device is reachable and responsive\n- **ADB server management**: Restart the ADB server from the GUI or CLI\n- **View and manage saved wireless devices**\n- **Update checker**: Automatically check for new versions with one click\n- **Cross-platform**: Works on Windows and Linux\n\n---\n\n## Installation\n\n[\u003cimg src=\"https://raw.githubusercontent.com/vadret/android/master/assets/get-github.png\" alt=\"Get it on GitHub\" height=\"70\"\u003e](https://github.com/anonfaded/FadADB/releases)\n\n### Windows (Recommended)\n\n- Download the latest installer from the [Releases](https://github.com/anonfaded/FadADB/releases/) page.\n- Run the installer and follow the prompts.\n- Launch FadADB from the Start Menu or Desktop shortcut.\n\n### From Source (Windows/Linux)\n\n1. Install Python 3.11+ (or newer)\n2. Install requirements:\n\n   ```sh\n   pip install -r requirements.txt\n   # or manually:\n   pip install pyqt6 colorama\n   ```\n\n3. Run:\n\n   ```sh\n   python FadADB.py\n   ```\n\n---\n\n## Usage\n\n### CLI\nRun:\n```sh\npython FadADB.py\n```\nOr launch the `FadADB.exe` if using the packaged version.\n\n**Main Menu Options:**\n1. Connect device\n2. Show connected devices\n3. Launch GUI\n4. Restart ADB Server\n5. Add device by IP (manual)\n6. Exit\n\n### GUI\n- Launch from the CLI menu or directly run `FadADB.exe` (or `python FadADB.py --gui`)\n- Features:\n  - Device list with connect/test/refresh\n  - Add device by IP (with example placeholder)\n  - View saved wireless devices (shows the path and JSON content)\n  - Restart ADB server from the GUI\n  - All logs and actions are shown in the interface\n\n---\n\n## How Wireless ADB Works\n- Plug in your device via USB and enable wireless debugging in developer options\n- FadADB will detect the device, fetch its IP, and connect wirelessly\n- Once connected, you can unplug USB and manage the device wirelessly\n- FadADB remembers your device's IP for future auto-reconnects\n- You can also manually add a device by IP if you know it\n\n**Note:** If your device's IP changes or wireless debugging is disabled, you may need to reconnect via USB to re-enable wireless ADB.\n\n---\n\n## State File\n- FadADB stores known wireless device IPs in `fadadb_state.json` (created next to the exe or script)\n- You can view and manage this file from the GUI\n- This file is ignored by git and not bundled in the installer\n\n---\n\n## Building\n\n### PyInstaller\n- Build a standalone exe with:\n  ```sh\n  pyinstaller FadADB.spec\n  ```\n- The output will be in `dist/FadADB/`\n- The spec file includes all necessary dependencies for features like the update checker\n\n---\n\n## Command Line Shortcut\n\n- You can run `fadadb` command from any terminal to launch the GUI.\n\n---\n\n## Requirements\n- Python 3.11+\n- PyQt6\n- colorama\n- adb (Android Debug Bridge) must be in your PATH\n\n---\n\n## Join Community\nJoin our [Discord server](https://discord.gg/kvAZvdkuuN) to share ideas, seek help, or connect with other users. Your feedback and contributions are welcome!\n\n[![Discord](https://img.shields.io/discord/1263384048194027520?label=Join%20Us%20on%20Discord\u0026logo=discord)](https://discord.gg/kvAZvdkuuN )\n\n\n## Support\n\n\u003ca href='https://ko-fi.com/D1D510FNSV' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi3.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n---\n\n## Contributions\nPull requests and suggestions are welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanonfaded%2Ffadadb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanonfaded%2Ffadadb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanonfaded%2Ffadadb/lists"}