The GNU/Linux module (prototype) is a combination of a Video4Linux2 device driver, and an executable app that will transfer the stream from the phone to the driver.

It’s assumed you are somewhat familiar with the system and how to use the Terminal. Also please keep in mind other posts on the blog are Windows oriented.


1. You must first remove any old versions of the client you have. Scroll down to the “Removal” section below.

2. If you are using an older Android device, check the version of DroidCam that was installed from the play store and run the appropriate commands from below.

For DroidCam & DroidCamX version 6 and above (newest):
cd /tmp/
sudo apt-get install linux-headers-`uname -r`
bits=`getconf LONG_BIT`
[[ ${bits} -eq 32 ]] && checksum=b4b4bb43a4e4a46aab2c1b38cd0892c3
[[ ${bits} -eq 64 ]] && checksum=743b71f1af4d90b5ced59c02fcbc925f
echo "${checksum}  droidcam-${bits}bit.tar.bz2" | md5sum -c --
# OK?
tar xjf droidcam-${bits}bit.tar.bz2
cd droidcam-${bits}bit/
sudo ./install

For DroidCam & DroidCamX below 6: [show]

Please download one the following packages to /tmp, extract and run sudo ./install 640 480
64-bit (f937c3510615af68c007b8c72deadb14), or 32-bit (73c6b9d853a0a6ab7c6d15174450a3f1).

* If you are running the newest Linux kernel (version 4 or above) and seeing errors, make sure your installed gcc version is 4.9 or above:
uname -r # prints linux version
gcc -v # prints gcc version

3. Once everything goes without error, you can ensure the device is installed with lsmod. Look for ‘v4l2loopback_dc’.

Open up a V4L2 compatible program (VLC player, Skype, Cheese, etc) and you should see DroidCam listed as a video device.

4. Start droidcam via the Terminal, or create a launcher if you’re using gnome. You can also try droidcam-cli -h.

5. Check the connection post on how to connect. If all goes well, you should see the output in the chat application, and you’re done!

A note about USB connections: The latest version of the client will try to invoke ‘adb’ automatically, provided the executable is found via the $PATH environment variable (ie. export PATH=$PATH:/path/to/adb).
The following commands are automatically executed:
adb start-server
adb devices # Look in output for a connected device
adb forward tcp:$port tcp:$port # $port = specified port on the client

The Linux client is open source.

Update webcam resolution

You may change the webcam output resolution as follows:

1. Close any programs using the droidcam webcam. Unload the device driver:
sudo rmmod v4l2loopback_dc

2. Re-load it as follows (WIDTH and HEIGHT are numbers). :
sudo insmod /lib/modules/`uname -r`/kernel/drivers/media/video/v4l2loopback-dc.ko width=WIDTH height=HEIGHT
Recommended resolutions: 320×240, 480×360, 640×480, 960×720 or 1280×720.

3. Restart the droidcam client to reload the settings, and test it out. You can keep changing the resolution.

4. Edit the text file /etc/modprobe.d/droidcam.conf with the new options to make the change stick.


To remove the DroidCam client (or existing old version):
Close any running programs. Run one of the following (depends which version of the linux client you got)
sudo /opt/droidcam-uninstall
# OR
sudo ~/.droidcam/uninstall
  1. dj says:

    i use ubuntu 16.04 and vlc, obs and cheese dont work with droidcam client

    but strangely guvcview woks.

    how i can get it work with obs ??

    • dev47 says:

      Not sure, tbh. Using standard resolution, 640×480?
      There is a *chance* something got changed in Ubuntu 16 (this wouldn’t be the first time) which broke the driver, but I can’t answer for sure at the moment.

  2. miko says:

    I got the following error following the installation instructions:
    insmod: ERROR: could not insert module /lib/modules/4.2.0-42-generic/kernel/drivers/media/video/v4l2loopback-dc.ko: Required key not available

    Could you please guide me?

  3. David SmartKnight says:

    While I undertand I need to open Terminal to install droidcam on my linux platform, my understanding of the syntax required is virtually minimal – and unsurprisingly I completely failed to install droidcam. The problem began on the 2nd line! I suspect ‘uname -r’ is something specific to my machine – but I don’t know if that is right, or, if it is, what that should be! Any chance of a “install for idiots” set of instructions?? Cheers

    • dev47 says:

      Do you know the distribution of GNU/Liunx you are running. Can you paste in the result of trying to run the above here?

  4. Aaron says:

    is it possible to disable auto white-balance/auto exposure in droidcam? Maybe as some v4l2loopback_dc-option?

    • dev47 says:

      Those are probably coming from the phone – and currently there are no options to adjust those, sorry.
      The app just keeps it all on default.

  5. DaVince says:

    wget fails with a 404 Not Found message… 🙁

    • dev47 says:

      Did you run bits=`getconf LONG_BIT`.
      Whats the output of getconf LONG_BIT on its own? Its supposed to return 32 or 64 depending on your CPU architecture type.

Leave a Reply

Your email address will not be published. Required fields are marked *


Follow @dev47apps