67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
|
|
# 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 (Developers)
|
|
|
|
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 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](https://github.com/JMR-dev)
|