Skip to content

5j54d93/Android-File-Transfer

Repository files navigation

Android File Transfer

GitHub license GitHub Repo stars GitHub repo size Platform

A fast, native macOS app for transferring files between your Mac and Android device over USB(MTP)or Wi-Fi(ADB):a Finder-like, open-source replacement for Google's discontinued Android File Transfer. Built with SwiftUI.

Overview

  1. Browse
  2. Transfer Files
  3. Connect over Wi-Fi
  4. Under the Hood
  5. Requirements
  6. License

Browse

A Finder-style source list of devices and storages on the left, and a multi-column file table(Name/Size/Kind/Date Modified)with a clickable breadcrumb path bar on the right.

  • Live sync:the list updates the instant a file is added or removed on the device — no refresh, no reopen.
  • Instant navigation:folders you've already opened reopen instantly from cache — no loading spinner — while refreshing in the background to stay current.
  • Storage gauge:the path bar shows used/free percentage plus the free space available, turning orange then red as the device fills up.
  • Finder conventions:double-click to open a folder, Return to rename, right-click empty space for New Folder, and create/rename/delete inline.

Transfer Files

Drag files from Finder onto the window to upload, and drag files out to Finder to download — both directions stream in the background.

  • File promises:dragging a file out completes the gesture instantly and downloads in the background to wherever you drop it, instead of freezing while the whole file copies.
  • Multi-file drag:select several files and drag them all out at once.
  • Full-window progress:transfers cover the window with a frosted-glass overlay and a centered card — current file, overall progress, speed, and ETA — that clears itself the moment everything finishes, with retry-on-failure if a transfer fails.
  • Large files:handles files larger than 4 GB in both directions.

Connect over Wi-Fi

No cable? Pair once and browse the device wirelessly — adb is bundled, so there's nothing to install.

  • Three ways to pair:scan a QR code, type a pairing code, or connect directly by IP : port from the phone's Wireless debugging screen.
  • Auto-discovery:paired devices on the same network are found over mDNS and connected automatically.
  • USB wins:the same phone reached over both USB and Wi-Fi is de-duplicated into a single device.

Under the Hood

  • MTPKit:a standalone, dependency-free Swift package that speaks the MTP protocol directly over IOUSBHost(no libmtp), alongside an ADB-over-Wi-Fi transport — both behind one shared DeviceTransport abstraction. The app pulls it in via Swift Package Manager.
  • SwiftUI + Observation@Observable view models throughout, with asyncawait and actors serializing all USB/ADB I/O.
  • Localized:English and 繁體中文 via String Catalogs.
  • Zero third-party dependencies:QR codes via Core Image, discovery via the Network framework, USB via IOUSBHost.

Requirements

  • macOS 26 or later
  • An Android device — a USB cable, or Wi-Fi with Wireless debugging enabled
  • Xcode 26 or later to build:open Android-File-Transfer.xcodeproj and run

License:MIT

This package is MIT licensed.

About

A fast, native macOS app for transferring files between your Mac and Android device over USB(MTP)or Wi-Fi(ADB): a Finder-like, open-source replacement for Google's discontinued Android File Transfer. Built with SwiftUI.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages