HandyCam

HandyCam is a Free Libre Open Source Software that works as a replacement client for the popular Smartphone Webcam Software Droidcam. It works in tandem with the Official Droidcam OBS Plugin. The purpose of HandyCam is to allow you to use any reasonably recent smartphone as a mobile webcam with OBS.

Features

• Select any quality settings your camera supports
• Stream low latency video to OBS
• Stream audio to OBS
• Stream screen to OBS
• Automatic Discovery of running HandyCam Servers in the Droidcam OBS Plugin
• Remotely start/stop the stream and control the camera settings using the webinterface or the restAPI
• Runs in the background with the screen off
• Connection over Wifi or USB (USB Debugging has to be enabled on the phone)
• Dark and light Theme depending on System Theme

Note: It's not possible to start the camera stream from the api if the app is not in the foreground

Installation

Install the Droidcam OBS Plugin from here or here and connect via the Wifi IP of your smartphone or via USB by turning on Android USB Debugging.

Manual

Either use the compiled APK from the releases tab or build it yourself with the magic of open source!

Obtainium

Android APKs are published to every release, and Obtainium keeps them updated straight from GitHub. Use the nightly channel to follow the rolling nightly tag, where prereleases and date-based version tracking have to be enabled.

Stable

Nightly

Setup & install

1. Install Obtainium.
2. Tap Add to Obtainium above. Stable opens the Add App page prefilled with https://github.com/TomOdellSheetMusic/HandyCam; nightly opens an import prompt, since it carries the prerelease and version-tracking settings the rolling nightly tag needs.

Tested with

• Samsung S22 Android 15
• Samsung S20 Android 12
• Samsung A50 Android 11
• Samsung Tab S10 FE

ToDo

• Implement new HEVC feature from droidcam plugin
• Clean up Code
• Remote Control Camera Focus
• Auto-Disover Phone Camera Capabilites
• Document restAPI
• Squash Bugs

Build Instructions

The easiest way to get going is to download and install Android Studio and use its inbuilt Version Control to clone/fork the HandyCam Repository. This should just work out of the box. Alternatively, you can use an IDE like VSCode and download the Android and JAVA JDKs separately. Then you need to point your system to them, for example:

[Environment]::SetEnvironmentVariable(
  "JAVA_HOME",
  "C:\Your\Path\To\Java\jdk-17.0.2",
  "User"
)

[Environment]::SetEnvironmentVariable(
  "ANDROID_HOME",
  "C:\You\Path\To\android-sdk",
  "User"
)       

and you should be able to run ./gradlew.bat.

License

HandyCam is licensed using the GPL-3.0 license.

The included icon is courtesy of janjf93 (link back not required by author if used)