From ProventusNova DeveloperWiki
No edit summary
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
= GStreamer Daemon =
= GStreamer Daemon (GstD) =
'''GStreamer Daemon (gst-daemon)''' is a service that allows remote control and management of GStreamer pipelines using a JSON-RPC API. This enables dynamic pipeline creation, modification, and execution without restarting applications.
'''GStreamer Daemon (GstD)''' is a service that enables '''remote control of GStreamer pipelines''' via <code>gst-client</code>. It allows:
* '''Remote pipeline management''' – Start, stop, modify pipelines dynamically.
* '''Multi-client access''' – Multiple users can control pipelines simultaneously.
* '''Embedded & network control''' – Use <code>gst-client</code> to manage pipelines over TCP or UNIX sockets.
* '''Low-latency communication''' – Ideal for '''real-time media applications'''.


== Installing GStreamer Daemon (`gstd`) ==
== 📌 Features ==
Before installing GStreamer Daemon, ensure you have the required dependencies.
* Remote control over pipelines via TCP/IP.
* Supports multiple pipelines simultaneously.
* JSON-RPC based API for pipeline manipulation.


== 🔗 How It Works ==
=== Build System & Development Tools ===
<pre>
GStreamer Daemon acts as a server that listens for commands over a network interface. It provides an easy way to create, modify, and control media pipelines remotely.
sudo apt install -y meson ninja-build git
</pre>


== 💡 Use Cases ==
=== GStreamer Core & Plugins ===
<pre>
***Embedded Systems** – Remote video processing without local UI.
sudo apt install -y gstreamer1.0-tools gstreamer1.0-plugins-base
***AI & Computer Vision** – Dynamically changing streams based on AI inference.
</pre>
***Cloud Streaming** – Managing video pipelines in real-time on cloud-based servers.


== 🚀 Example Commands ==
=== Additional GStreamer Plugins ===
<pre>
Create and run a pipeline:
sudo apt install -y gstreamer1.0-plugins-good gstreamer1.0-plugins-bad \
<syntaxhighlight lang="bash">
gstreamer1.0-plugins-ugly gstreamer1.0-libav
gst-client pipeline_create test_pipeline "videotestsrc ! autovideosink"
</pre>
gst-client play test_pipeline
</syntaxhighlight>


=== GStreamer Development Libraries ===
Stop the pipeline:
<pre>
<syntaxhighlight lang="bash">
sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
gst-client stop test_pipeline
</pre>
</syntaxhighlight>


=== GLib & D-Bus Dependencies ===
== 📖 References ==
<pre>
* [https://gstreamer.freedesktop.org/documentation/gst-daemon/ GStreamer Daemon Documentation]
sudo apt install -y libglib2.0-dev libdbus-1-dev libgirepository1.0-dev python3-gi
</pre>

=== Daemon & Networking Libraries ===
<pre>
sudo apt install -y libdaemon-dev libsoup2.4-dev
</pre>

=== JSON & Editing Support ===
<pre>
sudo apt install -y libjansson-dev libedit-dev
</pre>

=== Debugging Tools ===
<pre>
sudo apt install -y valgrind
</pre>

== Installing and Running GStreamer Daemon ==
To install GStreamer Daemon:
<pre>
git clone https://gitlab.freedesktop.org/gstreamer/gstd.git
cd gstd
meson build
ninja -C build
sudo ninja -C build install
</pre>

Verify installation:
<pre>
gstd --version
</pre>

To start the daemon:
<pre>
gstd -e --tcp-base-port=5000
</pre>

'''Note:''' The <code>-e</code> flag enables '''execution mode''', and <code>--tcp-base-port</code> sets the '''TCP control port'''.

== Controlling GStreamer Daemon with <code>gst-client</code> ==

Each command follows this format:

<pre>
gst-client COMMAND pipeline_name "PIPELINE_DESCRIPTION"
</pre>

=== Creating a Pipeline ===
<pre>
gst-client pipeline_create test_pipeline "videotestsrc ! videoconvert ! autovideosink"
</pre>

'''Parameters:'''
* '''pipeline_create''' – Creates a new pipeline.
* '''test_pipeline''' – Pipeline name (identifier).
* '''Pipeline elements:'''
- '''videotestsrc''' – Generates test video.
- '''videoconvert''' – Ensures format compatibility.
- '''autovideosink''' – Displays video output.

'''Use case:''' Used for '''testing video playback'''.

=== Starting a Pipeline ===
<pre>
gst-client pipeline_play test_pipeline
</pre>

'''Use case:''' Runs an existing '''paused''' pipeline.

=== Stopping a Pipeline ===
<pre>
gst-client pipeline_stop test_pipeline
</pre>

'''Use case:''' Pauses '''pipeline execution''' without deleting it.

=== Deleting a Pipeline ===
<pre>
gst-client pipeline_delete test_pipeline
</pre>

'''Use case:''' Frees up '''resources''' when a pipeline is no longer needed.

== Example: Transmitting an RTP Stream ==
<pre>
gst-client pipeline_create udp_stream "videotestsrc is-live=true pattern=ball ! videoconvert ! x264enc tune=zerolatency bitrate=500 speed-preset=ultrafast ! rtph264pay ! udpsink host=127.0.0.1 port=5002"
</pre>

'''Parameters:'''
* '''pipeline_create udp_stream''' – Creates a new pipeline named ''udp_stream''.
* '''videotestsrc is-live=true pattern=ball''' – Generates a moving '''ball pattern''' as a live video source.
- '''''is-live=true''''' – Ensures the video source behaves like a real-time stream.
- '''''pattern=ball''''' – Uses a bouncing ball as the test video pattern.
* '''videoconvert''' – Ensures compatibility with encoders and sinks.
* '''x264enc tune=zerolatency bitrate=500 speed-preset=ultrafast''' – Encodes video into '''H.264 format''' with low latency.
- '''''tune=zerolatency''''' – Optimizes the encoding for minimal delay.
- '''''bitrate=500''''' – Sets the '''bitrate''' to 500 kbps.
- '''''speed-preset=ultrafast''''' – Uses the '''fastest''' encoding preset.
* '''rtph264pay''' – Converts H.264 video into RTP packets for network transmission.
* '''udpsink host=127.0.0.1 port=5002''' – Sends the RTP stream to '''UDP port 5002''' on '''localhost'''.

'''Use case:''' '''Broadcasting an RTP stream''' over UDP.

=== Playing the RTP Transmission ===
<pre>
gst-client pipeline_play udp_stream
</pre>

'''Use case:''' Starts broadcasting the RTP stream.

=== Stopping the RTP Transmission ===
<pre>
gst-client pipeline_stop udp_stream
</pre>

'''Use case:''' Stops broadcasting the RTP stream without deleting it.

=== Deleting the RTP Transmission Pipeline ===
<pre>
gst-client pipeline_delete udp_stream
</pre>

'''Use case:''' Removes the RTP transmission pipeline.

== Example: Receiving an RTP Stream ==
<pre>
gst-client pipeline_create udp_receiver "udpsrc port=5002 ! application/x-rtp, encoding-name=H264 ! rtpjitterbuffer latency=100 ! rtph264depay ! avdec_h264 ! videoconvert ! autovideosink sync=false"
</pre>

'''Parameters:'''
* '''pipeline_create udp_receiver''' – Creates a new pipeline named ''udp_receiver''.
* '''udpsrc port=5002''' – Listens on '''UDP port 5002''' for incoming RTP packets.
* '''application/x-rtp, encoding-name=H264''' – Declares the '''media format''' as RTP with '''H.264 encoding'''.
* '''rtpjitterbuffer latency=100''' – Buffers packets to compensate for '''network jitter'''.
- '''''latency=100''''' – Sets a '''buffer delay''' of 100 milliseconds.
* '''rtph264depay''' – Extracts raw H.264 video from the RTP stream.
* '''avdec_h264''' – Decodes the H.264 video stream.
* '''videoconvert''' – Ensures compatibility before displaying the video.
* '''autovideosink sync=false''' – Displays the video, '''disabling synchronization''' for lower latency.

'''Use case:''' '''Receiving an RTP video stream''' over UDP.

=== Playing the RTP Receiver ===
<pre>
gst-client pipeline_play udp_receiver
</pre>

'''Use case:''' Starts the RTP receiver pipeline.

=== Stopping the RTP Receiver ===
<pre>
gst-client pipeline_stop udp_receiver
</pre>

'''Use case:''' Stops the RTP receiver pipeline without deleting it.

=== Deleting the RTP Receiver Pipeline ===
<pre>
gst-client pipeline_delete udp_receiver
</pre>

'''Use case:''' Removes the RTP receiver pipeline.

== Stopping GStreamer Daemon ==
To stop the GStreamer Daemon:
<pre>
gstd -k
</pre>

'''Use case:''' Terminates the running GStreamer Daemon (`gstd`).

== Checking if `gstd` is Running ==
To verify if GStreamer Daemon is running:
<pre>
ps aux | grep gstd
</pre>

'''Use case:''' Displays `gstd` processes if running.

== Summary ==
GStreamer Daemon enables '''remote control of pipelines''' via <code>gst-client</code>.

{| class="wikitable"
|+ '''GStreamer Daemon Key Features'''
|-
! Feature !! Description
|-
| '''Remote Pipeline Control''' || Manage GStreamer pipelines via <code>gst-client</code>
|-
| '''Dynamic Modification''' || Add/remove elements in real-time
|-
| '''Multi-Client Access''' || Multiple users can control pipelines
|-
| '''Embedded System Friendly''' || Works efficiently with TCP and UNIX socket connections
|}


= 🏗 Need a Solution for Your Project? =
Are you looking for ways to:

✅ Optimize your '''embedded system''' for better performance?

✅ Integrate '''AI and computer vision''' into your products?

✅ Improve '''multimedia processing''' for real-time applications?

✅ Develop a '''robust and scalable''' web platform?

Our team has helped businesses across multiple industries solve these challenges.

📩 '''Let’s collaborate!''' Contact us at '''[support@proventusnova.com](mailto:support@proventusnova.com)''' or visit '''[ProventusNova.com](https://proventusnova.com)''' to discuss your project. -->

Latest revision as of 03:50, 2 March 2025

GStreamer Daemon (GstD)

GStreamer Daemon (GstD) is a service that enables remote control of GStreamer pipelines via gst-client. It allows:

  • Remote pipeline management – Start, stop, modify pipelines dynamically.
  • Multi-client access – Multiple users can control pipelines simultaneously.
  • Embedded & network control – Use gst-client to manage pipelines over TCP or UNIX sockets.
  • Low-latency communication – Ideal for real-time media applications.

Installing GStreamer Daemon (`gstd`)

Before installing GStreamer Daemon, ensure you have the required dependencies.

Build System & Development Tools

sudo apt install -y meson ninja-build git

GStreamer Core & Plugins

sudo apt install -y gstreamer1.0-tools gstreamer1.0-plugins-base

Additional GStreamer Plugins

sudo apt install -y gstreamer1.0-plugins-good gstreamer1.0-plugins-bad \
  gstreamer1.0-plugins-ugly gstreamer1.0-libav

GStreamer Development Libraries

sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev

GLib & D-Bus Dependencies

sudo apt install -y libglib2.0-dev libdbus-1-dev libgirepository1.0-dev python3-gi

Daemon & Networking Libraries

sudo apt install -y libdaemon-dev libsoup2.4-dev

JSON & Editing Support

sudo apt install -y libjansson-dev libedit-dev

Debugging Tools

sudo apt install -y valgrind

Installing and Running GStreamer Daemon

To install GStreamer Daemon: 

git clone https://gitlab.freedesktop.org/gstreamer/gstd.git
cd gstd
meson build
ninja -C build
sudo ninja -C build install

Verify installation: 

gstd --version

To start the daemon: 

gstd -e --tcp-base-port=5000

Note: The -e flag enables execution mode, and --tcp-base-port sets the TCP control port.

Controlling GStreamer Daemon with gst-client

Each command follows this format: 

gst-client COMMAND pipeline_name "PIPELINE_DESCRIPTION"

Creating a Pipeline

gst-client pipeline_create test_pipeline "videotestsrc ! videoconvert ! autovideosink"

Parameters:

  • pipeline_create – Creates a new pipeline.
  • test_pipeline – Pipeline name (identifier).
  • Pipeline elements:
 - videotestsrc – Generates test video.
 - videoconvert – Ensures format compatibility.
 - autovideosink – Displays video output.

Use case: Used for testing video playback.

Starting a Pipeline

gst-client pipeline_play test_pipeline

Use case: Runs an existing paused pipeline.

Stopping a Pipeline

gst-client pipeline_stop test_pipeline

Use case: Pauses pipeline execution without deleting it.

Deleting a Pipeline

gst-client pipeline_delete test_pipeline

Use case: Frees up resources when a pipeline is no longer needed.

Example: Transmitting an RTP Stream

gst-client pipeline_create udp_stream "videotestsrc is-live=true pattern=ball ! videoconvert ! x264enc tune=zerolatency bitrate=500 speed-preset=ultrafast ! rtph264pay ! udpsink host=127.0.0.1 port=5002"

Parameters:

  • pipeline_create udp_stream – Creates a new pipeline named udp_stream.
  • videotestsrc is-live=true pattern=ball – Generates a moving ball pattern as a live video source.
 - is-live=true – Ensures the video source behaves like a real-time stream.
 - pattern=ball – Uses a bouncing ball as the test video pattern.
  • videoconvert – Ensures compatibility with encoders and sinks.
  • x264enc tune=zerolatency bitrate=500 speed-preset=ultrafast – Encodes video into H.264 format with low latency.
 - tune=zerolatency – Optimizes the encoding for minimal delay.
 - bitrate=500 – Sets the bitrate to 500 kbps.
 - speed-preset=ultrafast – Uses the fastest encoding preset.
  • rtph264pay – Converts H.264 video into RTP packets for network transmission.
  • udpsink host=127.0.0.1 port=5002 – Sends the RTP stream to UDP port 5002 on localhost.

Use case: Broadcasting an RTP stream over UDP.

Playing the RTP Transmission

gst-client pipeline_play udp_stream

Use case: Starts broadcasting the RTP stream.

Stopping the RTP Transmission

gst-client pipeline_stop udp_stream

Use case: Stops broadcasting the RTP stream without deleting it.

Deleting the RTP Transmission Pipeline

gst-client pipeline_delete udp_stream

Use case: Removes the RTP transmission pipeline.

Example: Receiving an RTP Stream

gst-client pipeline_create udp_receiver "udpsrc port=5002 ! application/x-rtp, encoding-name=H264 ! rtpjitterbuffer latency=100 ! rtph264depay ! avdec_h264 ! videoconvert ! autovideosink sync=false"

Parameters:

  • pipeline_create udp_receiver – Creates a new pipeline named udp_receiver.
  • udpsrc port=5002 – Listens on UDP port 5002 for incoming RTP packets.
  • application/x-rtp, encoding-name=H264 – Declares the media format as RTP with H.264 encoding.
  • rtpjitterbuffer latency=100 – Buffers packets to compensate for network jitter.
 - latency=100 – Sets a buffer delay of 100 milliseconds.
  • rtph264depay – Extracts raw H.264 video from the RTP stream.
  • avdec_h264 – Decodes the H.264 video stream.
  • videoconvert – Ensures compatibility before displaying the video.
  • autovideosink sync=false – Displays the video, disabling synchronization for lower latency.

Use case: Receiving an RTP video stream over UDP.

Playing the RTP Receiver

gst-client pipeline_play udp_receiver

Use case: Starts the RTP receiver pipeline.

Stopping the RTP Receiver

gst-client pipeline_stop udp_receiver

Use case: Stops the RTP receiver pipeline without deleting it.

Deleting the RTP Receiver Pipeline

gst-client pipeline_delete udp_receiver

Use case: Removes the RTP receiver pipeline.

Stopping GStreamer Daemon

To stop the GStreamer Daemon: 

gstd -k

Use case: Terminates the running GStreamer Daemon (`gstd`).

Checking if `gstd` is Running

To verify if GStreamer Daemon is running: 

ps aux | grep gstd

Use case: Displays `gstd` processes if running.

Summary

GStreamer Daemon enables remote control of pipelines via gst-client.

GStreamer Daemon Key Features
Feature Description
Remote Pipeline Control Manage GStreamer pipelines via gst-client
Dynamic Modification Add/remove elements in real-time
Multi-Client Access Multiple users can control pipelines
Embedded System Friendly Works efficiently with TCP and UNIX socket connections


🏗 Need a Solution for Your Project?

Are you looking for ways to:

✅ Optimize your embedded system for better performance?

✅ Integrate AI and computer vision into your products?

✅ Improve multimedia processing for real-time applications?

✅ Develop a robust and scalable web platform?

Our team has helped businesses across multiple industries solve these challenges.

📩 Let’s collaborate! Contact us at [support@proventusnova.com](mailto:support@proventusnova.com) or visit [ProventusNova.com](https://proventusnova.com) to discuss your project. -->

Retrieved from "https://developerwiki.proventusnova.com/index.php?title=GStreamer_Daemon&oldid=42"