{"id":50523064,"url":"https://github.com/Santosh7017/AndroidFileSync","last_synced_at":"2026-06-20T00:00:55.906Z","repository":{"id":342049676,"uuid":"1106161384","full_name":"Santosh7017/AndroidFileSync","owner":"Santosh7017","description":"AndroidFileSync: A free, native macOS app to transfer files between your Mac and Android phone — over USB or WiFi.","archived":false,"fork":false,"pushed_at":"2026-06-11T16:57:19.000Z","size":20271,"stargazers_count":95,"open_issues_count":2,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T18:21:10.507Z","etag":null,"topics":["adb","android","android-macos-fletransfer","filesharing","filetransfer","mac","macos","swift"],"latest_commit_sha":null,"homepage":"https://santosh7017.github.io/AndroidFileSync/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Santosh7017.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-28T18:21:27.000Z","updated_at":"2026-06-11T16:57:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Santosh7017/AndroidFileSync","commit_stats":null,"previous_names":["santosh7017/androidfilesync"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/Santosh7017/AndroidFileSync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santosh7017%2FAndroidFileSync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santosh7017%2FAndroidFileSync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santosh7017%2FAndroidFileSync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santosh7017%2FAndroidFileSync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Santosh7017","download_url":"https://codeload.github.com/Santosh7017/AndroidFileSync/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santosh7017%2FAndroidFileSync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34552295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adb","android","android-macos-fletransfer","filesharing","filetransfer","mac","macos","swift"],"created_at":"2026-06-03T06:00:31.032Z","updated_at":"2026-06-20T00:00:55.900Z","avatar_url":"https://github.com/Santosh7017.png","language":"Swift","funding_links":[],"categories":["Sharing Files"],"sub_categories":["Text"],"readme":"# AndroidFileSync\n\nA free, native macOS app to transfer files between your Mac and Android phone — over USB or WiFi.\n\nNo cloud. No Google account needed. Plug in via USB or connect wirelessly over WiFi.\n\n![SwiftUI](https://img.shields.io/badge/SwiftUI-macOS%2013%2B-blue)\n![Version](https://img.shields.io/badge/version-2.3.0-green)\n\n**[📥 Download Latest Version](#installation) • [🖼️ View Preview](#preview)**\n\n---\n\n## What Can It Do?\n\n- 📁 **Browse your phone like Finder** — Navigate folders, search, sort by name/size/type\n- 🖱️ **Drag \u0026 Drop** — Drag files from your Mac straight to your phone\n- 📶 **USB or WiFi** — Connect with a cable, or wirelessly over your home network\n- 👁️ **Preview files** — Double-click to view images, videos, and PDFs without downloading\n- 🚀 **Fast transfers** — Upload and download multiple files at the same time\n- ⚠️ **Duplicate detection** — Warns you before overwriting files that already exist\n- 🗑️ **Trash \u0026 Restore** — Deleted something by accident? Restore it, just like on macOS\n- ✂️ **Copy, Cut, Paste** — Move files between folders on your phone with clipboard shortcuts\n- 📝 **Rename \u0026 Batch operations** — Rename files, change extensions, delete in bulk\n- 💾 **SD Card support** — Browse and manage files on your external SD card\n- 📱 **App Manager** — Install, uninstall, disable and manage apps (System/User) on your Android device\n\n---\n\n## What You Need\n\n- A Mac running **macOS 13.0 (Ventura)** or later\n- An Android phone with a USB cable\n- For wireless: Android 11 or later\n\nThat's it. The app comes with everything else built in.\n\n---\n\n## Installation\n\n### Install via Homebrew (Recommended)\n\nThe easiest way to install AndroidFileSync is using [Homebrew](https://brew.sh/):\n\n```bash\nbrew tap santosh7017/androidfilesync\nbrew install --cask androidfilesync\n```\n\nTo update/upgrade to the latest version via Homebrew later, run:\n\n```bash\nbrew update\nbrew upgrade --cask androidfilesync\n```\n\n\u003e **Note:** You don't need to run any `xattr` commands when installing with Homebrew. Just install and open!\n\n### Install Manually (DMG)\n\n1. Go to [**Releases**](https://github.com/Santosh7017/AndroidFileSync/releases) and download the latest `.dmg` file\n2. Open the DMG and drag **AndroidFileSync** into your **Applications** folder\n3. Open **Terminal** (search for it in Spotlight) and paste this command:\n\n   ```bash\n   xattr -cr /Applications/AndroidFileSync.app\n   ```\n\n4. Launch the app — you're ready to go!\n\n\u003e **Why step 3?** macOS blocks apps that aren't from the App Store by default. This command tells your Mac it's safe to open. The app is fully open source — you can inspect every line of code yourself.\n\n### Build from Source (For Developers)\n\n```bash\ngit clone https://github.com/Santosh7017/AndroidFileSync.git\ncd AndroidFileSync\nopen AndroidFileSync.xcodeproj\n```\n\nPress ⌘R in Xcode to build and run. To create a DMG: `./build-dmg.sh`\n\n## Setting Up Your Android Phone (One-Time)\n\nBefore the app can talk to your phone, you need to enable a hidden developer setting. This only takes a minute and you only have to do it once.\n\n\u003e **These first two steps are required for both USB and WiFi connections.**\n\n### Step 1: Unlock Developer Options\n\n1. Open **Settings** on your Android phone\n2. Scroll down and tap **About Phone**\n3. Find **Build Number** and tap it **7 times** quickly\n4. You'll see a message: _\"You are now a developer!\"_\n\n\u003e **Samsung phones:** Go to **Settings → About Phone → Software Information → Build Number**\n\n### Step 2: Turn On USB Debugging\n\n1. Go back to **Settings**\n2. Search and Tap **Developer Options**\n3. Find **USB Debugging** and turn it **ON**\n4. Tap **OK** when it asks you to confirm\n\nNow choose your connection method below:\n\n---\n\n### 🔌 Option A: USB Connection (Wired)\n\nThe simplest way to connect. Just plug in a cable.\n\n1. Connect your phone to your Mac with a USB cable\n2. On your phone, you'll see a prompt: **\"Allow USB debugging?\"**\n3. Check **\"Always allow from this computer\"**\n4. Tap **Allow**\n5. Launch AndroidFileSync on your Mac — your phone will appear automatically\n\n\u003e **Tip:** If you don't see the \"Allow USB debugging?\" prompt, try unplugging and replugging the cable, or use a different USB port on your Mac.\n\n---\n\n### 📶 Option B: WiFi Connection (Wireless)\n\nNo cable needed. Your phone and Mac must be on the **same WiFi network**. Requires **Android 11** or later.\n\n#### Extra Setup: Turn On Wireless Debugging\n\n1. On your phone: go to **Settings → Developer Options**\n2. Find **Wireless Debugging** and turn it **ON**\n3. Tap on **Wireless Debugging** to open its settings\n\n#### Auto-Discovery Pairing (Easiest)\n\n1. Inside the Wireless Debugging settings, tap **Pair device with pairing code**\n2. In the Mac app: click the **WiFi** button — the **Auto-Discovery** tab will automatically detect your phone and pre-fill the connection details\n3. Type the **6-digit code** shown on your phone and click **Pair \u0026 Connect**\n\n\u003e **Got multiple phones?** A dropdown will appear letting you pick which device to connect to.\n\n#### Advanced Pairing (Manual)\n\nIf Auto-Discovery doesn't find your phone (for example, on a corporate network or VPN):\n\n1. Inside the Wireless Debugging settings, tap **Pair device with pairing code** — note the IP address, port, and code shown\n2. In the Mac app: click the **WiFi** button → **Advanced** tab → type in the IP, port, and code manually\n\n---\n\n## How to Use\n\n1. **Connect** your phone via USB or WiFi (using the steps above)\n2. **Launch** AndroidFileSync — it will automatically detect your device\n3. **Browse** your phone's files just like you would in Finder\n4. **Drag \u0026 drop** files from your Mac into the app window to upload them\n5. **Double-click** any file to preview it (images, videos, PDFs, documents)\n6. **Right-click** any file for more options (Download, Rename, Delete, Copy, Cut)\n\n\u003e A connection badge appears at the top: **blue** for USB, **green** for WiFi.\n\n---\n\n## Preview\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/2026-05-19_00-24-41.png\" width=\"800\" alt=\"AndroidFileSync Wireless Connection Screenshot\"\u003e\n  \u003cimg src=\"docs/2026-05-19_00-21-26.png\" width=\"800\" alt=\"AndroidFileSync Main Window\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003cimg src=\"docs/2026-05-19_00-22-37.png\" width=\"800\" alt=\"AndroidFileSync App Manager  Screenshot\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003cimg src=\"docs/2026-05-19_00-23-59.png\" width=\"800\" alt=\"AndroidFileSync Trash view Screenshot\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \n\u003c/p\u003e\n\n---\n\n## Troubleshooting\n\n| Problem                             | What to Do                                                                                  |\n| ----------------------------------- | ------------------------------------------------------------------------------------------- |\n| \"Scanning for Device...\" won't stop | Make sure USB Debugging is enabled and you tapped \"Allow\" on your phone                     |\n| Phone not showing up                | Try a different USB cable — some cables only charge and can't transfer data                 |\n| WiFi pairing fails                  | Make sure both your Mac and phone are on the same WiFi network                              |\n| Pairing code not working            | Go back to Wireless Debugging on your phone and tap \"Pair device\" again to get a fresh code |\n| Transfers are slow                  | Use a USB 3.0 cable and plug into a USB 3.0 port on your Mac                                |\n| Trash won't empty                   | Disconnect and reconnect your device, then try again                                        |\n| App won't launch                    | Make sure you're on macOS 13.0 or newer, and that you ran the `xattr` command from step 3   |\n\n---\n\n## All Features\n\n### Connectivity\n\n- **USB Connection** — Plug in and go, zero setup\n- **Wireless ADB (Android 11+)** — Connect over WiFi without a cable\n- **Auto-Discovery** — Automatically finds your phone on the network\n- **Advanced Pairing** — Manually enter connection details for complex network setups\n- **Multi-Device Selector** — Switch between multiple Android devices from a dropdown\n- **Context-Aware Disconnect** — Cleanly disconnect wireless devices when you're done\n\n### File Management\n\n- **File Browser** — Browse your phone's storage like a native Finder window\n- **SD Card Support** — Browse and manage files on your external SD card\n- **Drag \u0026 Drop** — Drag files from Finder straight to your phone\n- **Parallel Transfers** — Upload and download multiple files at the same time\n- **Conflict Resolution** — Detects duplicate files during uploads, lets you Skip or Replace\n- **Collision Prevention** — Automatically generates unique names when renaming or pasting to avoid overwrites\n- **Smart Sidebar** — Quick access to Camera, Downloads, Pictures, Music, SD Card — hides folders that don't exist on your device\n- **Native macOS Dialogs** — Polished rename and new folder prompts that feel right at home on Mac\n- **Search \u0026 Sort** — Search files instantly, sort by name, size, date, or type\n- **Batch Operations** — Change extensions or delete multiple files at once\n- **Copy, Cut \u0026 Paste** — Clipboard operations across folders on the device\n- **Trash \u0026 Restore** — Move files to trash and restore them later, just like macOS\n- **Delete Permanently** — Bypass Trash and permanently erase files/folders instantly\n- **File Preview** — Double-click to preview images, videos, PDFs, and documents\n- **Resizable Transfer Panel** — Collapsible, draggable progress view\n\n### App Management\n\n- **App Browser** — View all installed apps (User, System, Disabled) with icons and labels\n- **Install APK** — Sideload APK files directly from your Mac\n- **Uninstall Apps** — Remove user-installed apps with confirmation\n- **Disable System Apps** — Disable built-in system apps without rooting\n- **Re-enable Apps** — Restore previously disabled apps with one click\n- **Batch Actions** — Select multiple apps and uninstall/disable/enable them at once\n- **App Icons** — Real app icons extracted from APKs, with letter-avatar fallbacks\n- **Force Stop \u0026 Clear Data** — Stop misbehaving apps or wipe their data and cache\n- **Backup APK** — Save an app's APK file to your Mac before uninstalling\n\n### Safety\n\n- **Confirmation Dialogs** — All destructive actions (uninstall, disable, clear data) ask before proceeding\n- **Context-aware actions** — System tab shows Disable; Disabled tab shows Enable; User tab shows Uninstall\n\n---\n\n## Tech Stack\n\n- **SwiftUI** — Native macOS interface\n- **ADB** — Android Debug Bridge (bundled with the app)\n- **Swift Concurrency** — Async/await for parallel transfers\n- **Network.framework** — mDNS service discovery for wireless pairing\n- **CoreImage** — Image processing and thumbnail generation\n- **Quick Look** — Native file preview via macOS default apps\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSantosh7017%2FAndroidFileSync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSantosh7017%2FAndroidFileSync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSantosh7017%2FAndroidFileSync/lists"}