ScreenBridge

ScreenBridge Guides &
Troubleshooting

Step-by-step instructions to get ScreenBridge running on your system, plus solutions to the most common issues users encounter.

Setup Guide

Follow these steps to start mirroring your Android device with ScreenBridge. Need the files first? Download ScreenBridge here.

1

Enable Developer Options

On your Android device, open Settings, then go to About Phone. Tap Build Number seven times until you see the message"You are now a developer."

2

Turn On USB Debugging

Go back to Settings and open the new Developer Options menu. Find USB Debugging and toggle it on. Confirm the security prompt if one appears.

3

Install ADB Drivers (Windows)

Windows users may need to install ADB drivers for their specific device manufacturer. macOS and Linux users typically do not need additional drivers.

4

Connect via USB

Use a high-quality USB data cable (not a charge-only cable) to connect your Android device to your computer. Allow the computer to access your phone if prompted.

5

Launch ScreenBridge

Open a terminal or command prompt, navigate to the ScreenBridge directory, and run the ScreenBridge command. Your Android screen should appear on your computer within one second.

Wireless Setup

Use ScreenBridge without a cable after the initial USB pairing.

  1. Connect your Android device to your computer via USB.
  2. Open a terminal and run: adb tcpip 5555
  3. Disconnect the USB cable from your device.
  4. Find your device IP address in Settings > Wi-Fi > Network Details.
  5. Run: adb connect DEVICE_IP:5555
  6. Launch ScreenBridge normally. It will now work wirelessly.

Note: Both your computer and Android device must be connected to the same Wi-Fi network for wireless mode to function correctly.

Common Problems & Solutions

Solutions to issues that users most frequently report.

Device Not Detected

If ScreenBridge cannot find your device, try the following steps:

  • • Ensure USB debugging is enabled
  • • Try a different USB cable or port
  • • Install manufacturer-specific ADB drivers
  • • Revoke USB debugging authorizations and reauthorize

Black Screen or No Display

A black screen usually indicates a codec or display issue:

  • • Reduce resolution with --max-size 1024
  • • Switch video codec with --video-codec=h264
  • • Disable hardware acceleration if available
  • • Ensure the device screen is not locked

Lag or Stuttering

Performance issues can usually be resolved by adjusting settings:

  • • Lower the resolution with -m1024
  • • Reduce bit-rate with --bit-rate 2M
  • • Cap frame rate with --max-fps 30
  • • Use a USB 3.0 port instead of USB 2.0

Audio Not Working

Audio forwarding has specific requirements:

  • • Requires Android 11 or higher
  • • Disable audio with --no-audio if not needed
  • • Check that your PC audio output is working
  • • Try audio duplication mode if supported

Keyboard Input Issues

If typing does not work correctly:

  • • Enable"USB Debugging (Security Settings)" on Xiaomi/MIUI devices
  • • Reboot the device after enabling security settings
  • • Try HID keyboard mode with --keyboard=uhid
  • • Ensure no on-screen keyboard is blocking input

Antivirus Warnings

Some security software may flag ScreenBridge:

  • • This is a known false positive due to ADB interaction
  • • Add ScreenBridge to your antivirus whitelist
  • • Verify the SHA-256 hash of your download
  • • Build from source if you prefer full control

Best Practices

Tips to get the best performance and experience from ScreenBridge.

Use USB 3.0

USB 3.0 ports provide significantly more bandwidth than USB 2.0, resulting in higher frame rates and lower latency, especially at high resolutions.

Adjust for Hardware

Older computers and devices benefit from reduced resolution and bit-rate. Start with default settings and scale down if you experience performance issues.

Keep Drivers Updated

Ensure your device drivers and ADB installation are up to date. Outdated drivers are a common cause of connection and stability problems.

Download