Browse and transfer files between your Mac and Android device — no cables needed beyond USB for ADB. Runs a local web server you open in any browser.
- Lists connected Android devices via ADB
- Browse the full Android file system in a clean web UI
- Download files from your Android to your Mac
- Upload files from your Mac to your Android
| Requirement | Notes |
|---|---|
| macOS | Tested on macOS 13+ |
| Python 3.8+ | Comes with macOS or install via Homebrew |
| Android SDK Platform Tools | For adb — download here |
| USB debugging enabled | On your Android: Settings → Developer Options → USB Debugging |
1. Clone the repo
git clone https://github.com/sinisk3r/Mac-Android-Bridge.git
cd Mac-Android-Bridge2. Create a virtual environment and install dependencies
python3 -m venv .venv
source .venv/bin/activate
pip install flask3. Make sure ADB is at the expected path
The server looks for ADB at ~/Library/Android/sdk/platform-tools/adb.
If yours is elsewhere, update the ADB path in server.py line 7.
Option A — Terminal
bash start.shOption B — Double-click launcher (macOS)
Use the included Android-Browser.command shortcut (place it anywhere). Double-click opens the bridge in your browser automatically.
- Plug in your Android via USB
- Accept the "Allow USB debugging" prompt on your phone
- Open
http://localhost:7247(done automatically bystart.sh) - Select your device from the dropdown
- Browse, download, or upload files
.
├── server.py # Flask backend — ADB API endpoints
├── index.html # Frontend file browser UI
├── start.sh # Launch script (starts server + opens browser)
└── README.md
No devices showing up
- Run
adb devicesin terminal — device should appear asdevicenotunauthorized - Re-plug USB and accept the debugging prompt on your phone
ADB not found
- Install Android SDK Platform Tools and update the path in
server.py
Port already in use
start.shauto-kills any existing process on port 7247, but you can also run:lsof -ti tcp:7247 | xargs kill -9