PLEASE READ:

  • this tutorial assumes that the Dragonfly Java App has been already setup following the instructions available starting from this page.
  • before proceeding please be aware that the the FOV (field of view) of the standard smartphone cameras is typically narrow and this means that the Dragonfly engine cannot detect a large amount of features in the scene. This could causes the Dragonfly engine to get lost if the device moves too fast or if the device makes pure YAW rotations.

Your smartphone or tablet can easily be used as a wireless remote camera for Dragonfly streaming a video over WiFi or LTE using a third-party application.

1 – Calibration of the camera

  1. Open the browser on your smartphone/tablet and call the following URL:
  2. Follow the instructions shown inside the Dragonfly Web Calibration Tool or shown inside this page.
  3. At the end of the calibration process:
    1. click on the Download button and download the JSON calibration file generated by the calibration tool.
    2. move the JSON file from your smartphone to the Dragonfly machine (e.g. email/Dropbox/Google drive …).
    3. place the JSON calibration file inside the config folder (cd dragonfly_linux/application/Dragonfly2Java_jar/config).

2 – Setup the streaming App

First of all you need to ensure that your smartphone is accessible from the machine running the Dragonfly Java App (they need to be both on the same local network).

2.1 – IP webcam – on Android

  1. Download the IP Webcam App from the Google Play store at this link.
  2. Open the App and click on VIDEO PREFERENCES and select a VIDEO RESOLUTION of 640 x 480. Set the QUALITY parameter to 70 (or a closer value)!
  3. Go back to the main settings screen and under AUDIO MODE select DISABLE.
  4. Scroll down and click ENABLE THE SERVER.
  5. The app should display the camera preview and provide you with an URL of the video feed. Take note of the IP and port assigned to your device and go to section 3.

2.2 – Live-Reporter on iOS

  1. Download the Live-Reporter Security Camera App on the App Store at this link at this link.
  2. Open the App and Allow the permissions required.
  3. Change the default settings of the app to these settings:
    • Camera Setup 640 x 480;
    • Framerate 30fps;
    • Encode Quality Medium;
    • Key Frame 1sec.
  4. Take note of the IP (and default port – usually 554) assigned to your device starting with rtsp and go to section 3.

3 – Make use of the stream inside the Dragonfly Java App

  1. If not already done please setup the Dragonfly Java App following carefully the instructions available starting from this page.
  2. Launch the Dragonfly Java Web UI.
  3. Click on the Configuration tab:
    1. set the CAM_SOURCE parameter to the following string (where ip_of_your_device is the local IP address assigned to your smartphone provided by the 2 Apps described above):
      1. on Android:

      2. on iOS:

    2. set the CAM_CALIBRATION_FILE parameter to the name of the JSON calibration file placed inside the config folder at the root of the Dragonfly Java App installation folder (cd dragonfly_linux/application/Dragonfly2Java_jar/config)
    3. set the CAM IMAGE WIDTH and HEIGHT to 640 x 480.
  4. Click on Save and Restart.

Your device can now be used as a remote camera for Dragonfly. All the information about the Dragonfly Java App can be found inside this page.