@@ -9,17 +9,22 @@ WHERE TO START
9
9
--------------
10
10
11
11
We have a website at
12
- http://gstreamer.freedesktop.org/
13
12
14
- You should start by going through our FAQ at
15
- http://gstreamer.freedesktop.org/data/doc/gstreamer/head/faq/html/
13
+ https://gstreamer.freedesktop.org
16
14
17
- There is more documentation; go to
18
- http://gstreamer.freedesktop.org/documentation
15
+ Our documentation, including tutorials, API reference and FAQ can be found at
19
16
20
- You can subscribe to our mailing lists; see the website for details.
17
+ https://gstreamer.freedesktop.org/documentation/
21
18
22
- We track bugs in GNOME's bugzilla; see the website for details.
19
+ You can subscribe to our mailing lists:
20
+
21
+ https://lists.freedesktop.org/mailman/listinfo/gstreamer-announce
22
+
23
+ https://lists.freedesktop.org/mailman/listinfo/gstreamer-devel
24
+
25
+ We track bugs, feature requests and merge requests (patches) in GitLab at
26
+
27
+ https://gitlab.freedesktop.org/gstreamer/
23
28
24
29
You can join us on IRC - #gstreamer on irc.freenode.org
25
30
@@ -137,12 +142,11 @@ PLATFORMS
137
142
---------
138
143
139
144
- Linux is of course fully supported
140
- - FreeBSD is reported to work; other BSDs should work too
141
- - Solaris is reported to work; a specific sunaudiosink plugin has been written
142
- - MacOSX works, binary 1.x packages can be built using the cerbero build tool
145
+ - FreeBSD is reported to work; other BSDs should work too; same for Solaris
146
+ - MacOS works, binary 1.x packages can be built using the cerbero build tool
143
147
- Windows works; binary 1.x packages can be built using the cerbero build tool
144
148
- MSys/MinGW builds
145
- - Microsoft Visual Studio builds are not yet available or supported
149
+ - Microsoft Visual Studio builds are also available and supported
146
150
- Android works, binary 1.x packages can be built using the cerbero build tool
147
151
- iOS works
148
152
@@ -151,36 +155,49 @@ INSTALLING FROM PACKAGES
151
155
152
156
You should always prefer installing from packages first. GStreamer is
153
157
well-maintained for a number of distributions, including Fedora, Debian,
154
- Ubuntu, Mandrake, Gentoo, ...
158
+ Ubuntu, Mandrake, Arch Linux, Gentoo, ...
155
159
156
160
Only in cases where you:
157
- - want to hack on GStreamer
158
- - want to verify that a bug has been fixed
159
- - do not have a sane distribution
161
+
162
+ - want to hack on GStreamer
163
+ - want to verify that a bug has been fixed
164
+ - do not have a sane distribution
165
+
160
166
should you choose to build from source tarballs or git.
161
167
162
168
Find more information about the various packages at
163
- http://gstreamer.freedesktop.org/download/
169
+
170
+ https://gstreamer.freedesktop.org/download/
164
171
165
172
COMPILING FROM SOURCE TARBALLS
166
173
------------------------------
167
174
168
- - again, make sure that you really need to install from source !
175
+ - again, make sure that you really need to install from source!
169
176
If GStreamer is one of your first projects ever that you build from source,
170
177
consider taking on an easier project.
171
178
172
- - check output of ./configure --help to see if any options apply to you
179
+ - you need a recent version of Meson installed, see
180
+
181
+ http://mesonbuild.com/Getting-meson.html
182
+
183
+ and
184
+
185
+ https://gitlab.freedesktop.org/gstreamer/gst-build/blob/master/README.md
186
+
173
187
- run
174
- ./configure
175
- make
188
+
189
+ meson build
190
+ ninja -C build
176
191
177
192
to build GStreamer.
193
+
178
194
- if you want to install it (not required, but what you usually want to do), run
179
- make install
195
+
196
+ ninja -C build install
180
197
181
198
- try out a simple test:
182
- gst-launch -v fakesrc num_buffers=5 ! fakesink
183
- (If you didn't install GStreamer, prefix gst-launch with tools/ )
199
+ gst-launch-1.0 -v fakesrc num_buffers=5 ! fakesink
200
+ (If you didn't install GStreamer, run `./build/tools/ gst-launch-1.0` )
184
201
185
202
If it outputs a bunch of messages from fakesrc and fakesink, everything is
186
203
ok.
@@ -196,45 +213,25 @@ COMPILING FROM SOURCE TARBALLS
196
213
COMPILING FROM GIT
197
214
------------------
198
215
199
- When building from git sources, you will need to run autogen.sh to generate
200
- the build system files.
201
-
202
- You will need a set of additional tools typical for building from git,
203
- including:
204
- - autoconf
205
- - automake
206
- - libtool
207
-
208
- autogen.sh will check for recent enough versions and complain if you don't have
209
- them. You can also specify specific versions of automake and autoconf with
210
- --with-automake and --with-autoconf
211
-
212
- Check autogen.sh options by running autogen.sh --help
213
-
214
- autogen.sh can pass on arguments to configure
215
-
216
- When you have done this once, you can use autoregen.sh to re-autogen with
217
- the last passed options as a handy shortcut. Use it.
218
-
219
- After the autogen.sh stage, you can follow the directions listed in
220
- "COMPILING FROM SOURCE"
216
+ You can build an uninstalled GStreamer from git for development or testing
217
+ purposes without affecting your system installation.
221
218
222
- You can also run your whole git stack uninstalled in your home directory,
223
- so that you can quickly test changes without affecting your system setup or
224
- interfering with GStreamer installed from packages. Many GStreamer developers
225
- use an uninstalled setup for their work.
219
+ Get started with:
226
220
227
- There is a 'create-uninstalled-setup.sh' script in
221
+ git clone https://gitlab.freedesktop.org/gstreamer/gst-build
222
+ meson build
223
+ ninja -C build
224
+ ninja -C build uninstalled
228
225
229
- http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/
226
+ For more information, see the `gst-build` module and its documentation:
230
227
231
- to easily create an uninstalled setup from scratch.
228
+ https://gitlab.freedesktop.org/gstreamer/gst-build/blob/master/README.md
232
229
233
230
234
231
PLUG-IN DEPENDENCIES AND LICENSES
235
232
---------------------------------
236
233
237
- GStreamer is developed under the terms of the LGPL (see LICENSE file for
234
+ GStreamer is developed under the terms of the LGPL (see COPYING file for
238
235
details). Some of our plug-ins however rely on libraries which are available
239
236
under other licenses. This means that if you are distributing an application
240
237
which has a non-GPL compatible license (for instance a closed-source
0 commit comments