ADBtoolKit

A desktop GUI for Android Debug Bridge (ADB) and Scrcpy — connect to your Android device over Wi‑Fi and mirror its screen on your PC without using the command line.

---

Overview

ADBtoolKit lets you discover your device’s IP, connect it to the ADB server, and launch Scrcpy for wireless screen mirroring — all through a simple interface. No need to remember ADB or Scrcpy commands.

---

Features

• Device discovery — Get your Android device’s IP address from the app
• Wireless ADB — Connect the device to the ADB server over Wi‑Fi
• Scrcpy integration — Start Scrcpy with one click to view and control your phone on your PC
• No CLI required — Full workflow from a graphical interface
• Lightweight — Single executable; relies on your existing ADB and Scrcpy installation

---

Prerequisites

Before using ADBtoolKit, ensure you have:

Requirement	Description
Windows	Windows 10 or later (64‑bit recommended)
ADB	Android Platform Tools (ADB) installed and on your system PATH
Scrcpy	Scrcpy installed and on your system PATH
Android device	USB debugging enabled; for wireless use, device and PC on the same network

Adding tools to PATH (Windows)

1. Open Settings → System → About → Advanced system settings
2. Click Environment Variables
3. Under System variables or User variables, select Path → Edit
4. Add the folders where adb.exe and scrcpy.exe (or scrcpy) are located
5. Confirm with OK and restart any open terminals or ADBtoolKit

---

Installation

1. Download the latest ADBtoolKit release (e.g. adbToolkit.exe)
2. Place the executable in a folder of your choice (e.g. C:\Tools\ADBtoolKit)
3. Optionally add that folder to your PATH if you want to run it from the command line
4. Double‑click adbToolkit.exe to start the application

---

Usage

1. Launch ADBtoolKit — Run adbToolkit.exe
2. Get device IP — Use the in‑app option to retrieve your Android device’s IP address (or find it in Settings → About phone → Status on the device)
3. Connect via ADB — Enter the IP in ADBtoolKit and connect so the device is visible to ADB over Wi‑Fi
4. Start Scrcpy — Use the Scrcpy button to open the device screen on your PC

For the first wireless connection, you may need to connect the device once via USB and run adb tcpip 5555 (or use your tool’s equivalent) before switching to Wi‑Fi.

---

Project structure

ADBtoolKit/
├── README.md              # Documentation, setup, and usage
├── adbToolkit.exe         # Windows executable — main application
└── assets/                # Static assets and media
    └── adbToolkit.png     # Application screenshot

Path	Purpose
README.md	Project documentation, prerequisites, installation, and usage
adbToolkit.exe	ADBtoolKit Windows application binary
assets/	Images and other static assets (e.g. screenshots for the README)

---

Troubleshooting

• “ADB not found” / “Scrcpy not found” — Install ADB and Scrcpy and add their install directories to your system PATH (see Prerequisites).
• Device not showing over Wi‑Fi — Ensure USB debugging is on, device and PC are on the same network, and (if needed) you’ve done an initial USB connection and adb tcpip 5555.
• Connection refused — Check firewall rules and that no other tool is blocking ADB’s default port (usually 5555).

---

License

See the repository or distribution for license terms applicable to this project.