adb-gui/README.md

ADB Unlock, Screenshot & Scrcpy Tool

A simple Python GUI application that uses:

• ADB to unlock an Android device and take a screenshot
• Scrcpy to display and control an Android device (non-blocking)
• Tkinter for the GUI

Requirements

• Python 3 (with Tkinter installed):
  • On most systems, Python 3 will already include the tkinter module.
  • If you need to install it separately:
    • Debian/Ubuntu: sudo apt-get install python3-tk
    • macOS (Homebrew): brew install python-tk (though often included by default)
    • Windows: tkinter is usually included in the official Python installer.
• ADB (Android SDK Platform Tools) available on your PATH.
• Scrcpy installed and on your PATH (for screen mirroring).
• A devices.json file in the same directory, containing your device serials.

Example devices.json:

{
  "devices": [
    "emulator-5554",
    "emulator-5556",
    "device_serial_1",
    "device_serial_2"
  ]
}