September 8th, 2010 Leave a comment Go to comments

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+):
32-bit (850abe9f28b3e91dee520e8d4b40c1dc), or
64-bit (7e4e4d1255f2956e69488d237d34948c).

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 bash script is included that will automate the installation process.

Simply run sudo ./install 320 240 to install the client. sudo needed to register the device driver. 320 and 240 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 anytime, so it’s best to make sure 320×240 works first.

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

Interested in the source code? Great.

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. Mario Ray Mahardhika
    November 7th, 2014 at 09:29 | #1

    Do you have any plan on creating the same GUI interface as the Windows version? Especially some special functions such as mirroring.

    • dev47
      November 9th, 2014 at 11:52 | #2

      Hope so, just need to get the time.

  2. November 7th, 2014 at 12:37 | #3


    this Tool Droidcam works great. I try it with Skype, it is really cool.

    But now I want to play Webcam-Games (Online-Flash-Games) like Moskito Trouble. I’m sorry, but in the Adobe-Flash-Player-Settings I cannot choose the Droidcam.

    What can I do?????

    • dev47
      November 9th, 2014 at 11:59 | #4

      Flash is always having problems with “fake” webcams. Which resolution did you install the webcam with? I would stick to the most standard, 640×480, to make Flash happy.
      Check if there is an update, or try both Firefox/Chrome – might work in one of them.

  3. Jacob Riddel
    November 8th, 2014 at 18:42 | #5

    I directly installed and it didn’t install /dev/video[0-9]. Help please.
    Debian Jessie i586.

    • dev47
      November 9th, 2014 at 12:00 | #6

      Any more details? Any errors?
      Try rebooting the computer.

  4. bill ram
    November 20th, 2014 at 09:07 | #7

    Tried to install in fedora 20 , installation ended with following errors

    — INSTALL: Webcam parameters: ‘960’ and ‘720’
    — INSTALL: Home directory: /home/kartik/.droidcam
    — INSTALL: Building v4l2loopback-dc.ko
    make -C /lib/modules/`uname -r`/build M=`pwd`
    make: *** /lib/modules/3.16.7-200.fc20.x86_64/build: No such file or directory. Stop.
    make: *** [all] Error 2
    — INSTALL: v4l2loopback-dc.ko not built.. Failure

    what m I missing ?

    • dev47
      November 20th, 2014 at 21:36 | #8

      See if linux-headers are installed for your kernel version.

  5. Mario Ray Mahardhika
    November 23rd, 2014 at 07:59 | #9

    Same flash problem here. Google hangout doesn’t want to put droidcamx into the list, even with default resolution. Other apps, even LINE through WINE, does have it in the list. I wonder how this post ( can do it…

  6. Ramin
    December 4th, 2014 at 14:02 | #10

    Tried to install in Ubuntu 12.04…..installation ended with following errors

    — INSTALL: Webcam parameters: ‘320’ and ‘240’
    insmod: error inserting ‘/lib/modules/3.5.0-45-generic/kernel/drivers/media/video/v4l2loopback-dc.ko': -1 File exists

    • dev47
      December 4th, 2014 at 20:53 | #11

      Says “v4l2loopback-dc.ko’: -1 File exists”.. Please check the uninstall section on this page, and remove all mentioned files.
      You must have run the installer a 2nd time.
      .deb package coming soon!!

  7. Ramin
    December 7th, 2014 at 01:43 | #12

    i try to re-install it after remove every thing i got this error
    sudo ./install 320 240
    — INSTALL: Webcam parameters: ‘320’ and ‘240’
    — INSTALL: Creating /home/root/.droidcam
    mkdir: cannot create directory `/home/root/.droidcam': No such file or directory

    • dev47
      December 7th, 2014 at 11:18 | #13

      It says “mkdir: cannot create directory `/home/root/.droidcam': No such file or directory”
      Are you running as root? Do `mkdir /home/root/`, that should fix it.
      If you have a standard user that you normally use the computer with, you’ll have to move “/home/root/.droidcam” to /home/{user}/

Comment pages
1 4 5 6 12