Skip to content

About

Mac to Android browser bridge syncer

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mac-Android Bridge

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.

Platform Python


What it does

  • 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

Requirements

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

Setup

1. Clone the repo

git clone https://github.com/sinisk3r/Mac-Android-Bridge.git
cd Mac-Android-Bridge

2. Create a virtual environment and install dependencies

python3 -m venv .venv
source .venv/bin/activate
pip install flask

3. 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.


Running

Option A — Terminal

bash start.sh

Option B — Double-click launcher (macOS)

Use the included Android-Browser.command shortcut (place it anywhere). Double-click opens the bridge in your browser automatically.


Usage

  1. Plug in your Android via USB
  2. Accept the "Allow USB debugging" prompt on your phone
  3. Open http://localhost:7247 (done automatically by start.sh)
  4. Select your device from the dropdown
  5. Browse, download, or upload files

Project structure

.
├── server.py       # Flask backend — ADB API endpoints
├── index.html      # Frontend file browser UI
├── start.sh        # Launch script (starts server + opens browser)
└── README.md

Troubleshooting

No devices showing up

  • Run adb devices in terminal — device should appear as device not unauthorized
  • 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.sh auto-kills any existing process on port 7247, but you can also run: lsof -ti tcp:7247 | xargs kill -9

About

Mac to Android browser bridge syncer

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages