2025-10-16 18:51:32 -05:00
2025-10-16 18:51:32 -05:00
wip
2025-08-25 11:18:48 -05:00
2025-10-15 15:23:07 -05:00
2025-08-25 11:18:48 -05:00
2025-10-15 15:23:07 -05:00
2025-10-15 15:23:07 -05:00
2025-09-23 08:20:17 +08:00
2025-08-25 11:18:48 -05:00
2025-10-02 12:55:09 -05:00
2025-10-02 12:55:09 -05:00
2025-09-23 08:20:17 +08:00
2025-08-26 18:37:08 -05:00

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 git@github.com: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

S
Description
A simple file handler for Android that works over Android Debug Bridge to improve speed and simplicity of use
Readme
3.5 MiB
2025-09-28 21:16:25 +00:00
Languages
Python 98.2%
Shell 1.2%
PowerShell 0.6%