Configure an RTSP camera

The rtsp camera model supports streaming cameras with MJPEG tracks. The model doesn’t support streaming cameras with H264/MP4 tracks.

Navigate to the Config tab of your robot’s page in the Viam app. Click on the Components subtab and click Create component. Select the camera type, then select the rtsp model. Enter a name for your camera and click Create.

Configuration of a rtsp camera in the Viam app config builder.

Edit and fill in the attributes as applicable.

{
    "name": "<your-camera-name>",
    "type": "camera",
    "model" : "rtsp",
    "rtsp_address": "<your-rtsp-address>",
    "attributes": {
        "intrinsic_parameters": {
            "width_px": <int>,
            "height_px": <int>,
            "fx": <float>,
            "fy": <float>,
            "ppx": <float>,
            "ppy": <float>
        },
        "distortion_parameters": {
            "rk1": <float>,
            "rk2": <float>,
            "rk3": <float>,
            "tp1": <float>,
            "tp2": <float>
        }
    }
}

The following attributes are available for rtsp cameras:

NameTypeInclusionDescription
rtsp_addressstringRequiredThe RTSP address where the camera streams.
intrinsic_parametersobjectOptionalThe intrinsic parameters of the camera used to do 2D <-> 3D projections:
  • width_px: The expected width of the aligned image in pixels.
  • height_px: The expected height of the aligned image in pixels.
  • fx: The image center x point.
  • fy: The image center y point.
  • ppx: The image focal x.
  • ppy: The image focal y.
distortion_parametersobjectOptionalModified Brown-Conrady parameters used to correct for distortions caused by the shape of the camera lens:
  • rk1: The radial distortion x.
  • rk2: The radial distortion y.
  • rk3: The radial distortion z.
  • tp1: The tangential distortion x.
  • tp2: The tangential distortion y.

View the camera stream

Once your camera is configured and connected, go to the Control tab, and click on the camera’s dropdown menu. Then toggle the camera or the Point Cloud Data view to ON. If everything is configured correctly, you will see the live video feed from your camera. You can change the refresh frequency as needed to change bandwidth.

Example Camera view inside Viam app

Next Steps

Calibrate a Camera

Calibrate a camera and extract the intrinsic and distortion parameters.

transform

Instructions for transforming a camera.

Vision
Vision

The vision service enables your smart machine to use its on-board cameras to intelligently see and interpret the world around it.



Have questions, or want to meet other people working on robots? Join our Community Discord.