DroidCam OBS Usage

After the DroidCam OBS plugin is installed, re-start OBS Studio.

Add a 'DroidCam OBS' source to your scene.
In the source properties, choose 'Use WiFi' and enter the IP address displayed on the phone app. Your phone and computer must be connected to the same network/router.

Hit [Activate], and the source will try to connect with the app on the phone. If you dont see the Activate button, scroll down a bit in the source properties. To stop/modify any options, [Deactivate] the source.

*Do not enable audio, if you don't need it. This uses extra CPU.
*It is recommended to keep the phone at 100% battery and connected to power, to avoid any battery usage and extra heat.
*Click [Refresh Device List] to auto-discover devices. For WiFi discovery, make sure the phone app is open and multicast is allowed in your router settings.
*To use multiple phones, you can add another DroidCam OBS source to your scene.
*To use the same phone in multiple scenes, add the same Source to all of them; or make sure 'Deactivate when not showing' is enabled if you want different sources connecting to the same phone.

DroidCam OBS is free to use at standard definition. You can try HD video, but will need to purchase the pro upgrade to remove watermarks.

USB Setup

Use [Refresh Device List] to detect connected devices.
Ensure the USB cable is in good condition and the physical USB ports are not loose for a stable connection.

Android USB Setup

1. Unlock Developer Options in the phones Settings:

Open your phones main Settings and search for Build Number (usually under the About section).
Tap Build Number seven times to unlock Developer options.
Once unlocked, go back to the main Settings and search for USB Debugging (found under Developer Options) and turn this On.

2. With USB Debugging turned on, connect the phone via USB to the computer.

Your computer is ready to detect to the phone.

Windows PCs
Windows PCs will usually search for and install the appropriate drivers automatically at this time.

Linux PCs
No extra drivers are required, however adb must be installed.

Debian/Ubuntu: sudo apt-get install adb
ARCH Linux: sudo pacman -S android-tools
Fedora/SUSE: sudo yum install android-tools


Macs
No extra drivers are required.



3. In OBS Studio, open the DroidCam OBS properties, and click [Refresh Device List].
If the computer detects your phone, you'll likely get a dialog on the phone to Allow USB Debugging. Tap OK to allow the connection.



Check the Device drop-down and select the phone (instead of "Use WiFi"), then click Activate to connect the app.



4a. If the phone is not detected and you have a Windows PC - drivers for the phone may need to be installed manually:

For Google Pixel, Nexus, and OnePlus devices get the Google USB drivers here:
https://developer.android.com/studio/run/win-usb

Samsung USB drivers:
https://developer.samsung.com/mobile/android-usb-driver.html

LG Mobile Drivers:
https://www.lg.com/us/support/software-firmware-drivers
(scroll to Popular Software, LG Mobile Drivers section)

For other brands, this page provides links to most manufacturers websites:
http://developer.android.com/tools/extras/oem-usb.html#Drivers

You can also do a web search, ADB Drivers for ____.
Eg: ADB Drivers for HTC.

4b. On the phone, pull down the notification area and open "USB Options". If the mode is MTP (Media Transfer) change it to 'PTP' or just 'Charging'.

iOS USB Setup

Windows PCs
USB connections require the Apple USB drivers. Ensure that you have an authentic or Apple-approved data cable, and connect your iPhone to your Windows PC.
Wait for Windows to search for and install drivers automatically. To verify: hit the Windows key, search for Apps and Features, click on Open and check for 'Apple Mobile Device Support' in the list of apps.
If Apple Mobile Device Support is not listed, you can download and install yourself here: Apple Mobile Device Support (64-bit).

Make sure to Trust the computer on the phone if prompted:


In OBS Studio, open the DroidCam OBS properties and click [Refresh Device List]. Any available iOS devices will be added to the Device drop-down, which you can select instead of "Use WiFi":



If the device is not found, you can try getting iTunes in addition to the drivers. Install the desktop version of iTunes by following the Windows link under "other versions" here, or consult this help article by Apple on how to update your drivers.

Linux PCs
Install and run usbmuxd, the plugin will communicate with the usbmuxd service to detect and work with iPhones.

Macs
DroidCam iOS will show a special USB 169.254.X.X address when connected to a Mac computer, use it as the WiFi IP.
Try turning off Sync in Finder (Big Sur's replacement for iTunes), if the USB IP is not being shown on the app.

With the DroidCam app open (latest version), clicking [Refresh Device List] will search for and add available devices to the Device drop-down, which you can select instead of typing the address manually:




FAQs

Linux version crashes OBS

There is a bug with FFMpeg version 3.X (libavcodec-57). You'll need to make sure OBS is loading FFMpeg version 4.X (libavcodec-58).
You can also use the MJPEG video format (instead of AVC) as a work-around.

The plugin does not activate / Video does not start

Check if the WiFi IP in your DroidCam OBS source is correct and matches the phone app.
Make sure the computer and the phone are on the same network. Both wired (Ethernet) and wireless (WiFi) connections are fine.
If you have both 2.4Ghz and 5Ghz WiFi networks active, all devices need to be on the same network. Check your router options.

Try restarting your WiFi router: unplug from power, wait a few seconds, plug back in and let it start up.

If your computer has multiple network interfaces, make sure OBS Studio is using the correct one ("Bind IP" option under Advanced section in OBS Settings).

If your computer has VPN software installed, try connecting DroidCam before enabling VPN, or connect the app over USB to bypass the VPN.

If you have extra Firewalls enabled on your computer / your phone / your router – these might block the connection. Firewalls are usually present on corporate or school networks, and connecting via USB (or a WiFi hotspot) is the recommended workaround.

Video is not stable and keeps disconnecting

If you are using WiFi, the connection may not be strong enough to handle the data.
Try restarting your WiFi router: unplug from power, wait a few seconds, plug back in and let it start up.

In the phone app, open the Settings and under the Video section, (1) make sure "Advanced Options" are OFF, (2) Target Quality is 'Normal'.
In OBS studio, select 1280x720 (720p) for the DroidCam OBS source. If this works without issue you can try increasing the target quality or switching to 1080p.

USB connections will be more stable in general, but ensure the cable is good quality and the USB ports are not loose.

Read Error: timeout / Anti-Virus software error

Some Antivirus software block the connection from OBS to the phone. At this time it's unclear what the reason is.
Try adding obs64.exe (from the obs installation folder) as an exclusion / trusted / allowed program.

With Avast disable the Web Shields option.
With AVG disable the Web Protection option.
With Windows Defender, check the Real-Time Protection options.

MJPG or AVC

AVC is the recommended format. MJPG is little heavier on the CPU and the network, use it if you are getting too much delay with AVC.

Rotation, Flipping, Portrait Mode

You can rotate and mirror any video source in OBS Studio. Right click and use the 'Transform' menu to apply changes.

Ultrawide and Telephoto lenses

On Android, open the DroidCam OBS app settings and enable "Camera2 API". The app should now detect and offer more options in the main camera selection menu. With some newer phones, running Android 11+, extra lenses are accessible by zooming in/out while video is active.

Some phones, such as the Samsung Galaxy S21 Ultra, limit certain camera features to their own apps in which case DroidCam will not be able to access special lens(es).

On iOS, open DroidCam's settings and select your preferred lens before starting video.

Video pixelation from movement

Open the DroidCam OBS app settings, and set the video Target Quality to 'High' to reduce the pixelation.

If you have fast WiFi or a good USB connection, you can also enable Advanced Options here and select a custom bitrate instead of using the preset target quality options.
Consult the table below for 'Target Quality' to bitrate mappings when Advanced Options are OFF.

What are the 'Target Quality' presets for video?

Target QualityAVC 640x480AVC 960x720AVC 1280x720AVC 1920x1080I-FramesJPG
Low
Normal
High
Very High
0.6 Mbps
1 Mbps
1.2 Mbps
1.4 Mbps
2 Mbps
3 Mbps
4 Mbps
6 Mbps
3 Mbps
4 Mbps
6 Mbps
8 Mbps
5 Mbps
7 Mbps
8 Mbps
12 Mbps
3s
2s
1s
1s
60%
75%
85%
90%

Battery Optimizations

Streaming video will use a lot of resources on your phone.
DroidCam is designed to be minimalistic and save resources where possible.

* Do not enable audio, if you don't need it. This uses extra CPU.
* Keep the phone at 100% battery and connected to power, to avoid any battery usage and extra heat.
* Allow the phone screen to dim to reduce resource usage more.
* Reduce the target FPS to 30, or use 1280x720 instead of 1920x1080.
* Do not max out the video options. Keep "Advanced Options" off and use the "High" or "Very High" video quality preset in the app settings.
* Place the phone in a way that will let it dissipate heat.
* If you have a strong WiFi signal, try using WiFi instead of USB.


Remote Control

The app includes a remote control as part of the Pro upgrade, which you can open on your computer.

* The remote control does not show video, use it to control the camera (zoom, exposure, ..).
* The app can be connected over USB, while the remote is used over WiFi.
* The remote can be added as a custom browser dock directly inside OBS Studio (View > Docks).