2016-11-10 12:02:55 +00:00
|
|
|
# General
|
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## Is GStreamer a media player?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
No, GStreamer is a development framework for creating applications like
|
|
|
|
media players, video editors, streaming media broadcasters and so on.
|
|
|
|
That said, very good media players can easily be built on top of GStreamer
|
2016-11-14 00:53:17 +00:00
|
|
|
especially when using the high-level APIs we provide such as `GstPlayer` or
|
|
|
|
the `playbin` and `playbin3` elements.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## Why is GStreamer written in C? Why not C++/Objective-C/...?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
We like C. Aside from "personal preference", there are a number
|
|
|
|
of technical reasons why C is nice in this project:
|
|
|
|
|
|
|
|
- C is extremely portable.
|
|
|
|
|
|
|
|
- C is fast.
|
|
|
|
|
|
|
|
- It is easy to make language bindings for libraries written in C.
|
|
|
|
|
2017-08-15 17:30:50 +00:00
|
|
|
- The `GObject` object system provided by `GLib` implements objects in C,
|
2017-05-29 05:43:24 +00:00
|
|
|
in a portable and powerful way. This library provides for introspection
|
2016-11-10 12:02:55 +00:00
|
|
|
and runtime dynamic typing. It is a full OO system, but without the
|
|
|
|
syntactic sugar. If you want sugar, take a look at
|
|
|
|
[Vala](http://live.gnome.org/Vala).
|
|
|
|
|
|
|
|
- Use of C integrates nicely with Gtk+ and GNOME. Some people like
|
|
|
|
this a lot, but neither Gtk+ nor GNOME are required by GStreamer.
|
|
|
|
|
2016-11-14 00:53:17 +00:00
|
|
|
There are also historical reasons: When GStreamer was started, C++ and
|
|
|
|
free and open source C++ compilers were not as stable and mature as they
|
|
|
|
are today, and there was the desire to provide a certain degree of
|
|
|
|
API and ABI stability.
|
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
In closing, we like C. If you don't, that's fine; if you still want
|
2016-11-10 12:02:55 +00:00
|
|
|
to help out on GStreamer, we always need more language binding people.
|
2017-05-29 05:43:24 +00:00
|
|
|
If not, don't bother us; we're working :-)
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
## What kind of applications have been written in GStreamer?
|
2016-11-14 00:53:17 +00:00
|
|
|
|
|
|
|
GStreamer has been designed from the start to be a general-purpose multimedia
|
|
|
|
framework that can be used to write all kinds of multimedia applications.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-14 00:53:17 +00:00
|
|
|
There are a huge number of media playback applications of course, but also
|
|
|
|
audio and video capture applications that record to file or live stream the
|
|
|
|
captured content. Audio CD and DVD backup applications. Media format conversion
|
|
|
|
and transcoding tools. Streaming servers, both for small embedded devices where
|
|
|
|
resource usage needs to be tightly controlled, and for servers where scalability
|
|
|
|
is key. And of course audio and video editing applications.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
For a list of projects, look at the [application
|
|
|
|
list](http://gstreamer.freedesktop.org/apps/) on the GStreamer project
|
|
|
|
website.
|
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
## Does GStreamer support the format of my media files?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-14 00:53:17 +00:00
|
|
|
GStreamer is plugin based and was designed to be extensible from the start,
|
|
|
|
so it can pretty much support any media format provided suitable plugins
|
|
|
|
are available.
|
|
|
|
|
|
|
|
It features demuxers, parsers and decoders for all common media formats and
|
|
|
|
hundreds of uncommon ones. If you have trouble playing back a file please
|
|
|
|
first make sure you have all the required plug-ins installed.
|
|
|
|
|
2016-11-10 12:02:55 +00:00
|
|
|
GStreamer aims to support every format imaginable, but that
|
|
|
|
doesn't mean the developers have managed to achieve that aim yet. If a
|
|
|
|
GStreamer enabled application doesn't play back your files, you can help
|
|
|
|
us solve that problem by [filing an enhancement request
|
2018-08-01 04:20:27 +00:00
|
|
|
issue](https://gitlab.freedesktop.org/gstreamer) for that format. If you have it,
|
|
|
|
please provide:
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
- links to other players, preferably Open Source and working on Unix
|
|
|
|
|
|
|
|
- links to explanations of the format.
|
|
|
|
|
|
|
|
- ways to obtain mediafiles in that format to test.
|
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
## What are the exact licensing terms for GStreamer and its plugins?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
All of GStreamer, including our own plugin code, is licensed
|
|
|
|
under the [GNU LGPL 2.1](http://www.gnu.org/licenses/lgpl-2.1.html)
|
|
|
|
license. Some of the libraries we use for some of the plugins are
|
|
|
|
however under the GPL, which means that those plugins can not be used by
|
2016-11-14 00:53:17 +00:00
|
|
|
a non-GPL-compatible application. Those are few and far between though
|
|
|
|
and there are usually non-GPL alternatives available for those GPL libraries.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-08-15 21:10:28 +00:00
|
|
|
As a general rule, GStreamer aims at using only LGPL or BSD licensed
|
|
|
|
libraries and only use GPL or proprietary libraries when no good LGPL or BSD
|
2016-11-10 12:02:55 +00:00
|
|
|
alternatives are available.
|
|
|
|
|
2017-08-15 21:10:28 +00:00
|
|
|
You can see the effective license of a plugin as the **License** field in
|
|
|
|
the output of the following command:
|
|
|
|
|
|
|
|
```
|
|
|
|
gst-inspect-1.0 <plugin name>
|
|
|
|
```
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## Is GStreamer a sound server?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
No, GStreamer is not a sound server. GStreamer does, however, have
|
|
|
|
plugins supporting most of the major sound servers available today,
|
2016-11-14 00:53:17 +00:00
|
|
|
including pulseaudio, Jack and others.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
## Is GStreamer available for platforms other than Linux?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-14 00:53:17 +00:00
|
|
|
Yes, GStreamer is a cross-platform multimedia framework that
|
|
|
|
works on all major operating systems, including but not limited to
|
|
|
|
Linux, Android, iOS, macOS, Windows, and *BSD, and there are official
|
|
|
|
SDK binary packages for Android, iOS, macOS and Windows made available
|
|
|
|
with every GStreamer release.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## What is GStreamer's relationship with the GNOME community?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2016-11-14 00:53:17 +00:00
|
|
|
GStreamer is an independent project, but we do traditionally have
|
2016-11-10 12:02:55 +00:00
|
|
|
a close relationship with the GNOME community. Many of our hackers
|
|
|
|
consider themselves also to be members of the GNOME community. GStreamer
|
2016-11-14 00:53:17 +00:00
|
|
|
is officially bundled with the GNOME desktop, as lots of GNOME applications
|
|
|
|
are using it. This does not exclude use of GStreamer by other communities
|
|
|
|
at all, of course.
|
2016-11-10 12:02:55 +00:00
|
|
|
|
2017-06-02 22:34:40 +00:00
|
|
|
## What is GStreamer's relationship with the KDE community?
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
The GStreamer community wants to have as good a relationship as
|
|
|
|
possible with KDE, and we hope that someday KDE decides to adopt
|
2016-11-14 00:53:17 +00:00
|
|
|
GStreamer as their multimedia platform. There have been contacts
|
|
|
|
from time to time between the GStreamer community and KDE and
|
|
|
|
GStreamer is used by various KDE and Qt multimedia APIs. Also,
|
2016-11-10 12:02:55 +00:00
|
|
|
some of the KDE hackers have created Qt bindings of GStreamer, made a
|
|
|
|
simple video player and using it in some audio players (JuK and AmaroK).
|
|
|
|
|
2017-05-29 05:43:24 +00:00
|
|
|
## I'm considering adding GStreamer output to my application...
|
2016-11-10 12:02:55 +00:00
|
|
|
|
|
|
|
That doesn't really make sense. GStreamer is not a sound server,
|
|
|
|
so you don't output directly to GStreamer, and it's not an intermediate
|
|
|
|
API between audio data and different kinds of audio sinks. It is a
|
2016-11-14 00:53:17 +00:00
|
|
|
fundamental design decision to use GStreamer in your application; there are
|
|
|
|
no easy ways of somehow 'transfering' data from your app to GStreamer (well,
|
|
|
|
there are of course, but they would be reserved for special use cases).
|
|
|
|
Instead, your application would have to use or implement a number of GStreamer
|
2016-11-10 12:02:55 +00:00
|
|
|
elements, string them together, and tell them to run. In that manner the
|
|
|
|
data would all be internal to the GStreamer pipeline.
|
|
|
|
|
|
|
|
That said, it is possible to write a plugin specific to your app that
|
2016-11-14 00:53:17 +00:00
|
|
|
can get at the audio or video data.
|