Any USB camera connected to a machine running Ubuntu or Windows (from now on the SOURCE machine) can be used as a remote USB camera that streams the video over a wireless connection to a different computing unit that runs Dragonfly (from now on the CLIENT machine).

If the USB camera is connected DIRECTLY to the computing unit that runs Dragonfly
If you are interested in how to configure a USB camera directly connected to the Dragonfly machine please go to this page.

1 – On Ubuntu

1.1 – Install Gstreamer

We use Gstreamer to stream the video from the SOURCE machine. To install it, enter the following commands on your SOURCE machine:

sudo apt-get -y install libgstreamer1.0-dev
sudo apt-get -y install libgstreamer-plugins-base1.0-dev
sudo apt-get -y install gstreamer1.0-libav
sudo apt-get -y install gstreamer1.0-plugins-bad
sudo apt-get -y install gstreamer1.0-tools
sudo apt-get -y install gstreamer1.0-plugins-good
sudo apt-get -y install gstreamer1.0-plugins-ugly
sudo apt-get -y install gstreamer1.0-nice

1.2 – Activate the streaming

On the SOURCE machine:

Connect the USB camera.
Launch the following command to list all video devices picked up by Ubuntu in order to find the ID of the USB camera:
```
sudo apt-get install v4l-utils
v4l2-ctl --list-devices
```
Why do you see 2 IDs for each camera?
There is a common bug on Ubuntu 18.04 where 2 indexes are displayed for each USB camera. When configuring the Camera source field inside the Configuration tab of the Dragonfly Web user interface, please use the first index of the two.

Launch one of the following commands to activate the video stream (ip_of_your_device is the local IP address assigned to the SOURCE machine and port_number is the port number that you would like to assign to the streaming device):

MJPEG streaming – use this solution if the hardware does not allow live H264 encoding, or if H264 is not satisfying:

gst-launch-1.0 v4l2src device=/dev/video0 ! 'video/x-raw,width=640,height=480,framerate=30/1' ! decodebin name=dec ! queue ! videoconvert ! jpegenc ! queue ! multipartmux ! tcpserversink host=ip_of_your_device port=port_number

H264 streaming – much lower bandwidth requirements than MJPEG, but requires live encoding and some CPUs might not be powerful enough.

gst-launch-1.0 v4l2src device=/dev/video0 ! 'video/x-raw,width=640,height=480,framerate=30/1' ! videoconvert ! x264enc tune=zerolatency byte-stream=true ! rtph264pay ! gdppay ! tcpserversink host=ip_of_your_device port=port_number sync=false

H264 (accelerated) streaming – same as H264 streaming, but does not require a powerful CPU encoding. However, all platforms are not compatible. Raspberry Pi and Jetson Nano should work fine.

gst-launch-1.0 v4l2src device=/dev/video0 ! 'video/x-raw,width=640,height=480,framerate=30/1' ! videoconvert ! omxh264enc ! rtph264pay ! gdppay ! tcpserversink host=ip_of_your_device port=port_number sync=false

1.3 – Make the video stream available to Dragonfly

Launch Dragonfly on the CLIENT machine.

Click on the Configuration tab:

Set the Camera source parameter to one of the following strings, depending on the type of streaming activated on the SOURCE machine (ip_of_your_device is the local IP address assigned to the SOURCE machine and port_number is the port number assigned to the streaming device on the SOURCE machine):

For MJPEG streaming:

gstreamer:tcpclientsrc host=ip_of_your_device port=port_number ! multipartdemux ! image/jpeg, framerate=30/1 ! jpegparse ! jpegdec ! videoconvert ! appsink sync=false

For H264 streaming:

gstreamer:tcpclientsrc host=ip_of_your_device port=port_number ! gdpdepay ! rtph264depay ! avdec_h264 ! videoconvert ! appsink sync=false

For H264 (accelerated) streaming:

gstreamer:tcpclientsrc host=ip_of_your_device port=port_number ! gdpdepay ! rtph264depay ! avdec_h264 ! videoconvert ! appsink sync=false

Click on Save and Restart.

2 – On Windows

2.1 – Install Gstreamer

Download Gstreamer from this link:

Gstreamer MinGW Runtime

Launch the setup, and during the installation process:

select CUSTOM.
click on “GStreamer 1.0” and choose “ENTIRE FEATURES WILL BE INSTALLED ON LOCAL DRIVE“.
take note of the location where Gstreamer will be installed (e.g. C:\gstreamer\). You will need it later.

Add Gstreamer to the environment variables. To do so:

In Search, start typing “Environment Variables” and then click on
Click the Advanced system settings link.
Click Environment Variables.
In the section System Variables find the Path environment variable and select it. Click Edit. If the Path environment variable does not exist, click New.
In the Edit System Variable (or New System Variable) window, insert the path to the gstreamer executable. Assuming an installation of Gstreamer is inside C:\gstreamer\ then the path to add will have to be this:
- C:\gstreamer\1.0\mingw_x86_64\bin
Click OK. Close all remaining windows by clicking OK.

2.2 – Activate the streaming