# 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](https://python-poetry.org/) for dependency management
- (Optional) pyenv for Python version managment

## Installation

1. Clone this repository:

   ```sh
   git clone git@github.com:JMR-dev/android_file_handler_adb.git
   cd android_file_handler_adb
   ```

2. Install dependencies using Poetry:

   ```sh
   poetry install
   ```

## Usage

1. Activate the virtual environment:

   ```sh
   poetry env activate
   ```

2. Run the application:

   ```sh
   poetry run python3 src/main.py
   ```

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](https://github.com/JMR-dev)