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. Text in blue should be executed in 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. Download (for DroidCam v4.0+, DroidCamX v4.0+):
64-bit (f937c3510615af68c007b8c72deadb14), or
32-bit (73c6b9d853a0a6ab7c6d15174450a3f1).

3. Extract everything to the desktop or another folder. Make sure there are no spaces in the path.

4. Open up Terminal, cd ~/Desktop/droidcam-?? (or /whatever). A simple shell script is included that will automate the installation process:
Run sudo ./install 640 480 to install the client.

sudo needed to register the device driver. 640 and 480 are optional, this is the output resolution for the webcam. Replace them with one of 320 240, 480 360, 640 480, or 960 720. You can change this after the install as well.

The installer creates a settings directory as /home/`logname`/.droidcam. If you’re running as root, make sure you move it to your standard users home directory.

If no errors are displayed, you can ensure the device is installed with lsmod.

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

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

7. 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! Remember to delete the install folder from step 3.

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: sudo insmod /lib/modules/`uname -r`/kernel/drivers/media/video/v4l2loopback-dc.ko width=WIDTH height=HEIGHT (Where WIDTH and HEIGHT are numbers).
Recommended resolutions: 320×240, 480×360, 640×480, 960×720 or 1280×720.

3. Edit the first line of the text file ~/.droidcam/settings so the frames are resized properly (specify the same resolution as in 2). Restart the client to reload the settings.

4. Test the webcam with whatever programs you wish. You can keep changing the resolution.

5. Edit the text file /etc/modules so the webcam gets reloaded with the new resolution after reboot.


To remove the DroidCam client (or existing old version):

Close any running programs. Open the command line.
run `sudo ~/.droidcam/uninstall` which does the following:

– Unload the V4L driver: sudo rmmod v4l2loopback-dc.
– Delete the driver file and the client executable:
sudo rm -f /usr/bin/droidcam /usr/bin/droidcam-cli
sudo rm -f /lib/modules/`uname -r`/kernel/drivers/media/video/v4l2loopback-dc.ko

– Get rid of droidcam and ‘videodev’ in /etc/modules

Finally, Delete ~/.droidcam/ folder

  1. Nico says:

    Hi i’ve tried the app on a Samsung s2 i9100 with Replicant 4.2 and it seems to work fine.
    But when i try the Linux Client on Trisquel 7 i got the green screen on my laptop on the following apps:Skype/Cheese/GUVCview.
    Same thing happen on Linux Mint 17.2 on the same apps(Skype/Cheese/GUVCview).
    On the Linux mint 17.2 i’ve even tried to change the resolution from 640×480 to 1280×720 with no luck.I always get “GREEN SCREEN” on the apps.
    What should i try next?

    • dev47 says:

      The green screen is basically the “idle” state of the webcam. The green data is supposed to be overwritten by actual image frames when the webcam starts streaming.
      Does the client connect OK? Try the cli client, in the terminal type `droidcam-cli -h`.
      To be honest I am not sure what else to suggest – not sure why the video stream wouldn’t get passed down to the webcam. Since you are seeing the green screen, the webcam driver is definitely working OK.

  2. trav says:

    Latest apk causes segmentation fault on Linux, it runs for about minute then crashes.

  3. Sven says:

    Is there any hope that we’ll see a Linux version with working sound anytime soon? I love droidcam, but without the mic working I’m hesitating to buy the pro version. :(

    • dev47 says:

      Its been tough getting free time, there is a proof of concept that works and needs to be formalized and released.
      I dont think I can give an good estimate, maybe after the summer.

      • Sven says:

        I know how much developers hate to be asked about release dates. So I really appreciate that you are trying to give an estimate! :)

        Anyway, I’m looking forward to the update — whenever it’ll be released! :)

  4. filipe says:


  5. @irvb says:

    Lo there !
    Excuse my poor english !
    I installed Droidcam on a lubuntu .
    It works fine till i don’t reboot lubuntu

    i have this msg when i boot :
    systemd-modules-load[2032]: Failed to find module ‘v4l2loopback-dc width=640 height=480′
    sept. 17 08:26:30 test systemd[1]: systemd-modules-load.service: main process exited, code=exited, status=1/FAILURE

    I check that the file v4l2loopback-dc.ko is present here :

    uninstall et install again works fine !

    any idea to load the module fine at the launch ?


    • dev47 says:

      Check the /etc/modules file, see if it looks clean. You can try adjusting the v4l2loopback-dc reference there to use the full “/lib/modules/3.19.0-28-generic/kernel/…” path.

Leave a Reply

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


You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>