LogoLogo
Buy SoftwareBuy HardwareOpen a ticket
Rekor Scout®
Rekor Scout®
  • 🌟Getting Started
    • Overview
    • Additional ALPR and Vehicle Recognition Products
    • Countries and Regions Supported
    • Vehicle Characteristics Supported
    • Create an Account
    • Subscriptions and Licensing
  • 🧠Agent
    • System Requirements
    • Benchmarking
    • Installation
    • License Registration
    • Set Data Destination
    • Connect to Cameras
    • Configuration
      • Agent Properties
      • Camera Streams
      • NVIDIA GPU Acceleration
      • Restarting the Agent
  • 📹Camera Configuration
    • Camera Placement Guide
    • Lighting
    • Camera Positioning
    • Pixels on Target
    • Camera Image Settings
  • 🕸️Web Server
    • Overview
    • Cloud
    • Self-Hosted
    • Configuring Agents
    • REST API
  • 🖥️Dashboard
    • Overview
    • Account Settings
    • Quick Search
    • Quick View Panels
    • Latest Reads (“Most Recent Plate Groups”)
    • Alerts List
    • Top Sites of the Week
    • Dispatch Map
    • Video Review
    • Statistics
    • Analytic Reports
    • Advanced Search
    • Rekor CarCheck®
    • Search Audit
    • Guides and Support
    • Billing and Subscriptions
      • Change Your Plan
      • Update Billing Address
      • Update Payment Method
      • Review Billing History
      • Cancel Your Subscription
    • Configuration
      • Alerts
      • Agents
      • Licensed Agents
      • WebHooks
      • User Management
      • Integrations
  • 🔗Application Integration
    • Overview
    • Integrating with the Agent
    • Receiving HTTP POSTs
    • Pulling from the Queue
    • JSON Plate Results
    • JSON Group Results
    • JSON Heartbeat
    • Local Image Retrieval
Powered by GitBook
LogoLogo

Platforms

  • Rekor Discover® for Urban Mobility
  • Rekor Command® for Transportation
  • Rekor Scout® for Public Safety

Systems

  • Rekor Edge Flex™ (Classificaiton)
  • Rekor Edge Max™ (Classification)
  • Rekor Edge Pro (ALPR)
  • Rekor Edge Max™ (ALPR)

Developers

  • Vehicle Recognition SDK
  • Rekor CarCheck®
  • Rekor AutoNotice™

Resources

  • About Us
  • Customer Stories
  • Newsroom
  • Help Center

© 2025 Rekor Systems, Inc. All Rights Reserved.

On this page
  • Custom GStreamer Pipeline
  • Webcam
  • Video File
  • RTSP/H264 Camera

Was this helpful?

  1. Agent
  2. Configuration

Camera Streams

PreviousAgent PropertiesNextNVIDIA GPU Acceleration

Last updated 1 year ago

Was this helpful?

The agent must be configured to connect to one or more camera streams to process license plates. Scout expects to receive a URL specifying the HTTP or RTSP stream location on the IP camera. You should be able to find this URL by consulting your camera’s user manual, or with the help of an ONVIF-capable discovery tool. Once you have found the URL, you can test the stream with a video player such as .

To add a camera stream:

  1. Create a new unique file in the folder /etc/openalpr/stream.d/ with the extension .conf. For example, create a file named my_new_camera.conf.

  2. Add the following content:

    camera_id = [some unique number]
    stream = [Camera HTTP/RTSP stream URL]
  3. Restart the Scout Agent.

Once restarted, you should see the agent successfully connecting to the camera in the log file /var/log/alpr.log

Each camera configuration file may optionally be configured with the following settings:

  • prewarp - A series of numbers that adjusts the rotation/angle of the camera image before processing. The exact value can be obtained through the Scout configuration utility.

  • detection_mask_image - The path to a black and white image file creates a mask over the video stream before processing. Black areas are ignored, white areas are scanned for plates.

Custom GStreamer Pipeline

In some cases, you may require more control over the process that grabs video from your device and makes it available to Scout. The Scout Agent and Scout SDK both allow you to configure a custom GStreamer Pipeline which can handle pulling video from your camera. is open source and supports user plug-ins that allow you to write your own C code in case you need to utilize 3rd party device drivers to pull the data.

To get started, you should first familiarize yourself with GStreamer pipelines. The following are a few examples of pulling video from various sources. gst-launch-1.0 is a command-line program that will execute the pipeline and display the output.

Webcam

gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,framerate=30/1,width=1280,height=720 ! decodebin ! videoconvert ! video/x-raw,format=BGR ! videoconvert ! autovideosink

Video File

gst-launch-1.0 filesrc location=/tmp/video.mp4 ! decodebin ! videoconvert ! video/x-raw,format=BGR ! videoconvert ! autovideosink

RTSP/H264 Camera

gst-launch-1.0 rtspsrc location=rtsp://192.168.0.100/video user-id=testuser user-pw=test drop-on-latency=1 latency=1000 ! queue max-size-buffers=0 max-size-time=0 max-size-bytes=0 min-threshold-time=10 ! rtph264depay ! h264parse ! decodebin ! videoconvert ! video/x-raw,format=BGR ! videoconvert ! autovideosink
  1. Edit /etc/openalpr/stream.d/[cameraname].conf

  2. Add gstreamer_format = [your custom gstreamer pipeline]

  3. Remove the autovideosink and replace it with appsink name=sink max-buffers=5

  4. Make sure you do not include the gst-launch-1.0 command at the beginning. Also, avoid quote marks as these will cause a syntax error from GStreamer’s parser

  5. Lastly, add stream = [any_string] and camera_id = [any_number]. These are required for the agent to recognize your configuration file as a proper camera

A complete configuration example using the webcam pipeline above would be:

stream = dummy
camera_id = 1234
gstreamer_format = v4l2src device=/dev/video0 ! video/x-raw,framerate=30/1,width=1280,height=720 ! decodebin ! videoconvert ! video/x-raw,format=BGR ! videoconvert ! appsink name=sink max-buffers=5

If you are using the Scout SDK, you will apply the pipeline to the API function connect_video_stream_url by passing it a string for gstreamer_pipeline_format.

Once you have experimented with to display video, you can now integrate it with Scout. Our software will see the video exactly as the gst-launch-1.0 command displays it. If using the agent, you can add your custom GStreamer format as follows:

🧠
VLC
GStreamer
GStreamer