Turn your Android phone into a wired secondary monitor for your Mac via USB
Stream your Mac screen to your Android device with minimal latency using a USB connection. Perfect for extending your workspace or monitoring applications while on the go.
- 🚀 Low Latency: Direct USB connection for fast, reliable streaming
- 🖥️ Menu Bar App: Clean macOS menu bar integration - no dock clutter
- 📱 Native Android: Smooth, hardware-accelerated video decoding
- 🔒 Privacy First: No internet required - everything stays local
- ⚡ Easy Setup: Automated ADB configuration and port forwarding
Download the latest pre-built apps from GitHub Releases:
- For Mac: Download
MacDisplay.dmg - For Android: Download
AndroidMacDisplay-debug.apk
- Download
MacDisplay.dmgfrom the latest release - Open the DMG file
- Drag
MacDisplay.appto your Applications folder - Open the app from Applications
- Grant Permissions:
- First launch will request Screen Recording permission
- Go to System Preferences → Privacy & Security → Screen Recording
- Enable permission for MacDisplay
- Restart the app
The app will appear in your menu bar (top-right corner of screen).
- Download
AndroidMacDisplay-debug.apkfrom the latest release - Transfer the APK to your Android device
- Enable "Install from Unknown Sources":
- Go to Settings → Security → Install Unknown Apps
- Allow your file manager or browser to install apps
- Tap the APK file to install
- Enable Developer Options (if not already enabled):
- Go to Settings → About Phone
- Tap Build Number 7 times
- Enable USB Debugging:
- Go to Settings → System → Developer Options
- Toggle USB Debugging ON
-
USB Cable: A data-capable USB cable (not just charging-only)
-
ADB (Android Debug Bridge) on your Mac:
brew install android-platform-tools
(If you have Android Studio, you already have ADB)
- Connect your Android device to your Mac via USB
- Open MacDisplay app on Mac (menu bar icon)
- Open Android Mac Display app on your phone
- Accept the USB debugging prompt on your Android device
- Watch your Mac screen appear on your phone! 🎉
The Mac app will automatically:
- ✅ Detect your connected Android device via ADB
- ✅ Configure port forwarding
- ✅ Start streaming your screen
Click the menu bar icon to access:
- Streaming Status: See if streaming is active
- Connected Device: View connected Android device info
- Start/Stop Streaming: Manual control
- Quit: Exit the application
- macOS 13.0 or later
- Swift 6.2 or later
- Xcode Command Line Tools
cd MacServer
chmod +x build_mac_app.sh
./build_mac_app.shThis will:
- Build the Swift package in release mode
- Create a proper
.appbundle - Sign the application
- Install to
/Applications - Launch the app
cd MacServer
swift build -c release
swift run # For testing- Android Studio Arctic Fox or later
- JDK 17 or later
- Android SDK 26+ (Android 8.0 or higher)
- Open the
AndroidClientfolder in Android Studio - Wait for Gradle sync to complete
- Select Build → Build Bundle(s) / APK(s) → Build APK(s)
- Find APK in
AndroidClient/app/build/outputs/apk/
cd AndroidClient
# Debug build
./gradlew assembleDebug
# Release build (unsigned)
./gradlew assembleReleaseAPKs will be in app/build/outputs/apk/debug/ or release/.
"MacDisplay" cannot be opened because the developer cannot be verified
- Right-click the app → Open → Confirm
- Or: System Preferences → Security & Privacy → Click "Open Anyway"
Black screen on Android
- Ensure Screen Recording permission is granted in System Preferences
- Quit and restart the Mac app
- Check that ADB is working:
adb devicesshould list your device
"ADB not found" error
- Install ADB:
brew install android-platform-tools - Restart the Mac app
App not installing
- Enable "Install from Unknown Sources" for your browser/file manager
- Try:
adb install AndroidMacDisplay-debug.apk
USB debugging not working
- Revoke USB debugging authorizations: Settings → Developer Options
- Reconnect USB and accept the prompt
- Check cable - some cables are charge-only
Black screen / "Not Connected"
- Ensure USB debugging is enabled
- Check that Mac app is running
- Try disconnecting and reconnecting USB
- Run
adb deviceson Mac to verify device is detected
Laggy video
- Use a high-quality USB cable (USB 3.0 recommended)
- Close other apps on Android to free up resources
- Try a lower resolution setting (future feature)
- ScreenCapture: Captures Mac screen frames using
SCShareableContent - VideoEncoder: Encodes frames to H.264 using
VideoToolbox - TCPServer: Streams encoded video over TCP
- USBManager: Manages ADB and port forwarding
- MacApp: SwiftUI menu bar interface
- MainActivity: Main UI with TextureView for video display
- TCPClient: Connects to Mac server via forwarded port
- VideoDecoder: Hardware-accelerated H.264 decoding using
MediaCodec
- Mac app starts TCP server on port 8000
- ADB reverse port forwards Android's localhost:8000 → Mac's localhost:8000
- Android app connects to localhost:8000
- Mac streams H.264-encoded video frames
- Android decodes and displays in real-time
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes
- Test on both Mac and Android
- Commit:
git commit -m 'Add amazing feature' - Push:
git push origin feature/amazing-feature - Open a Pull Request
This project is open source and available under the MIT License.