Skip to main content

GStreamer

GStreamer is a powerful tool which allows streaming complex video pipes over network. Simple pipelines to stream and receive video provided below.

Stream h.264@30fps over network

Show MJPEG stream on the LCD
gst-launch-1.0 -v v4l2src device=/dev/video0 ! image/jpeg, width=1920, height=1080, framerate=30/1 ! jpegdec ! videoconvert ! queue ! autovideosink
Stream h.264 compressed video over UDP socket
gst-launch-1.0 -v v4l2src device=/dev/video2 do-timestamp=true ! video/x-h264, width=1920, \ 
height=1080, framerate=30/1 ! h264parse ! queue ! \ 
rtph264pay config-interval=10 pt=96 ! udpsink \ 
host=192.168.0.111 port=5600 sync=false
Receive stream and display on monitor
gst-launch-1.0 -e -v udpsrc port=5600 ! application/x-rtp, encoding-name=H264,payload=96 ! \ 
rtpjitterbuffer ! rtph264depay ! avdec_h264 ! autovideosink

Some other helpful pipelines

Receive, display and record video
gst-launch-1.0 -e -v udpsrc port=5600 ! tee name=STREAMOUT ! \ 
tee name=VIDEOWINDOW ! queue ! application/x-rtp, encoding-name=H264, payload=96 ! \ 
rtph264depay ! h264parse ! mp4mux ! filesink location=myvideo.mp4 STREAMOUT. ! \ 
queue ! udpsink port=5700 VIDEOWINDOW. ! queue ! application/x-rtp, \ 
payload=96 ! rtph264depay ! avdec_h264 ! autovideosink
Display h.264 stream (Windows)
gst-launch-1.0.exe ksvideosrc ! \ 
video/x-raw,format=H264,width=1920 ! \ 
capssetter caps=video/x-h264,format=byte-stream join=false ! \ 
queue ! \ 
h264parse ! \ 
avdec_h264 ! \ 
autovideosink

Not all firmware modifications are supported by gstreamer. If you experiencing streaming issues, feel free to contact us. Update procedure is detailed here.

Inspect video device capabilities

Video device details can be inspected with video4linux command v4l2-ctl --device /dev/video2 --all Video device should support H.264 pixel format. Various firmware modifications can have different configuration parameters and

Driver Info:
        Driver name      : uvcvideo
        Card type        : KurokesuC1_536     : Kurokesu C
        Bus info         : usb-0000:01:00.0-1.3
        Driver version   : 5.10.11
        Capabilities     : 0x84a00001
                Video Capture
                Metadata Capture
                Streaming
                Extended Pix Format
                Device Capabilities
        Device Caps      : 0x04200001
                Video Capture
                Streaming
                Extended Pix Format
Media Driver Info:
        Driver name      : uvcvideo
        Model            : KurokesuC1_536     : Kurokesu C
        Serial           : SN000000
        Bus info         : usb-0000:01:00.0-1.3
        Media version    : 5.10.11
        Hardware revision: 0x00000100 (256)
        Driver version   : 5.10.11
Interface Info:
        ID               : 0x03000008
        Type             : V4L Video
Entity Info:
        ID               : 0x00000007 (7)
        Name             : KurokesuC1_536     : Kurokesu C
        Function         : V4L2 I/O
        Pad 0x01000011   : 0: Sink
          Link 0x0200001e: from remote pad 0x1000010 of entity 'Extension 4': Data, Enabled, Immutable
Priority: 2
Video input : 0 (Camera 1: ok)
Format Video Capture:
        Width/Height      : 1920/1080
        Pixel Format      : 'H264' (H.264)
        Field             : None
        Bytes per Line    : 3840
        Size Image        : 2073600
        Colorspace        : sRGB
        Transfer Function : Rec. 709
        YCbCr/HSV Encoding: ITU-R 601
        Quantization      : Default (maps to Full Range)
        Flags             :
Crop Capability Video Capture:
        Bounds      : Left 0, Top 0, Width 1920, Height 1080
        Default     : Left 0, Top 0, Width 1920, Height 1080
        Pixel Aspect: 1/1
Selection: crop_default, Left 0, Top 0, Width 1920, Height 1080, Flags:
Selection: crop_bounds, Left 0, Top 0, Width 1920, Height 1080, Flags:
Streaming Parameters Video Capture:
        Capabilities     : timeperframe
        Frames per second: 30.000 (30/1)
        Read buffers     : 0
                     brightness 0x00980900 (int)    : min=-64 max=64 step=1 default=0 value=0
                       contrast 0x00980901 (int)    : min=0 max=64 step=1 default=32 value=32
                     saturation 0x00980902 (int)    : min=0 max=128 step=1 default=52 value=52
                            hue 0x00980903 (int)    : min=-40 max=40 step=1 default=0 value=0
 white_balance_temperature_auto 0x0098090c (bool)   : default=1 value=1
                          gamma 0x00980910 (int)    : min=72 max=500 step=1 default=100 value=100
                           gain 0x00980913 (int)    : min=0 max=100 step=1 default=0 value=0
           power_line_frequency 0x00980918 (menu)   : min=0 max=2 default=2 value=2
      white_balance_temperature 0x0098091a (int)    : min=2800 max=9300 step=1 default=4600 value=4600 flags=inactive
                      sharpness 0x0098091b (int)    : min=0 max=6 step=1 default=3 value=3
         backlight_compensation 0x0098091c (int)    : min=0 max=2 step=1 default=1 value=1
                  exposure_auto 0x009a0901 (menu)   : min=0 max=3 default=3 value=3
              exposure_absolute 0x009a0902 (int)    : min=1 max=5000 step=1 default=156 value=156 flags=inactive
         exposure_auto_priority 0x009a0903 (bool)   : default=0 value=0

Debugging

Useful commands:

  • gst-launch-1.0 --gst-version - read gstreamer version (tested with GStreamer Core Library version 1.14.4)