gstreamer-cheat-sheet/README.md

55 lines
2.7 KiB
Markdown
Raw Normal View History

2018-02-20 12:26:20 +00:00
# GStreamer command-line cheat sheet
2018-02-20 12:23:23 +00:00
This series of docs provides a cheat sheet for GStreamer on the command-line.
2018-03-25 22:43:39 +00:00
A few Python examples are also included for when you need GStreamer to be dynamic (i.e. react to user or some other action).
2018-02-20 12:23:23 +00:00
## Contents
* [Test streams](test_streams.md)
* [Basics](basics.md)
* [RTMP](rtmp.md)
2018-03-25 22:45:02 +00:00
* [Mixing video & audio](mixing.md)
* [Images](images.md)
2018-02-20 13:12:12 +00:00
* [Capturing images](capturing_images.md)
2018-04-03 21:51:32 +00:00
* [Sending to multiple destinations (tee)](tee.md)
2018-02-25 17:16:08 +00:00
* [Sending/receiving video from shared memory](memory_transfer.md)
* [Network transfer](network_transfer.md) (including how to send so that VLC can preview)
2018-02-20 12:23:23 +00:00
2018-02-20 12:26:20 +00:00
## Sources and references
* [Basic command line reference](http://docs.gstreamer.com/display/GstSDK/Basic+tutorial+10%3A+GStreamer+tools)
2018-03-26 10:08:07 +00:00
* [Pipeline examples](https://gstreamer.freedesktop.org/documentation/tools/gst-launch.html#pipeline-examples)
2018-02-20 12:26:20 +00:00
* [List of all Gstreamer plugins](https://gstreamer.freedesktop.org/documentation/plugins.html)
* [Handy elements](https://gstreamer.freedesktop.org/documentation/tutorials/basic/handy-elements.html#uridecodebin)
2018-02-20 12:23:23 +00:00
## Other cheat-sheets
* http://wiki.oz9aec.net/index.php/Gstreamer_cheat_sheet
* https://github.com/xmementoit/gstreamerCheatsheet/blob/master/README.md
* https://gist.github.com/nebgnahz/26a60cd28f671a8b7f522e80e75a9aa5
2018-03-26 10:08:07 +00:00
## Interacting with the GStreamer pipeline
2018-02-25 17:16:08 +00:00
2018-04-03 21:51:32 +00:00
If you want to interact with GStreamer after it's started (e.g. respond to an event, or dynamically change a pipeline), the command-line GStreamer doesn't really cut it. Instead, here are some options:
2018-02-25 17:16:08 +00:00
* *[GStreamer Daemon (gstd)](https://github.com/RidgeRun/gstd-1.x)* - allows setting and updating via a TCP connection
2018-06-04 17:02:31 +00:00
* *[Snowmix](http://snowmix.sourceforge.net/)* - an open-source live video mixer
2018-02-25 17:16:08 +00:00
* *Develop using the GStreamer library*, in either [C](https://gstreamer.freedesktop.org/documentation/application-development/basics/helloworld.html), [Python](https://github.com/GStreamer/gst-python), or [C#/.NET](https://github.com/GStreamer/gstreamer-sharp)
### Python with GStreamer
Good GStreamer Python resources include:
* [Getting started with GStreamer with Python](https://www.jonobacon.com/2006/08/28/getting-started-with-gstreamer-with-python/)
2018-02-25 17:16:08 +00:00
* [Python GStreamer Tutorial](http://brettviren.github.io/pygst-tutorial-org/pygst-tutorial.html)
2018-03-20 08:18:38 +00:00
* [Function reference](http://lazka.github.io/pgi-docs/#Gst-1.0)
* [Nice example script](https://github.com/rabits/rstream/blob/master/rstream.py)
### C++ with GStreamer
My favourite reference is [Valadoc](https://valadoc.org/gstreamer-1.0/index.htm)
2018-02-25 17:16:08 +00:00
# Problems or suggestions with this guide?
If you spot anything incorrect or incomplete, reports are welcome, either using [issues](issues) or [pull requests](pulls)