Android File Handler (ADB)

A simple Windows GUI tool to pull folders from an Android device using ADB (Android Debug Bridge). The tool automatically downloads the latest ADB platform-tools if not present, checks for a connected device, and provides a user-friendly interface for selecting remote and local single files and folders.

Features

• Automatic ADB Download: Downloads and extracts the latest platform-tools if not found locally.
• Device Detection: Checks for a connected Android device and provides instructions if not found.
• GUI Interface: Easy-to-use interface built with Tkinter for selecting remote (Android) and local (PC) folders.
• Progress Bar: Visual feedback during file transfer.
• USB Debugging Guidance: Step-by-step instructions for enabling/disabling USB debugging on your device.

Requirements

• Windows or Linux
• Python 3.8+
• Poetry for dependency management
• (Optional) pyenv for Python version managment

Installation (Developers)

1. Clone this repository:

   git clone [email protected]:JMR-dev/android_file_handler_adb.git
   cd android_file_handler_adb

2. Install dependencies using Poetry:

   poetry install

Usage

1. Activate the virtual environment:

   poetry env activate

2. Run the application:

   poetry run python -m src.main 

3. Follow the on-screen instructions:

   • Enter the remote folder path (e.g., /sdcard/DCIM)
   • Choose the local destination folder
   • Click Start Transfer

Troubleshooting

• ADB not found: The tool will attempt to download and extract ADB automatically.
• No device detected: Ensure your device is connected via USB and USB debugging is enabled. The app provides instructions if needed.

License

MIT License

Author

JMR-dev