gstreamer/installing-on-linux.md

# Installing on Linux

## Prerequisites

GStreamer is included in all Linux distributions. We recommend using the latest version of a fast moving distribution such as Fedora, Ubuntu (non-LTS), Debian sid or OpenSuse to get a recent GStreamer release.

All the commands given in this section are intended to be typed in from
a terminal.

> ![Warning](images/icons/emoticons/warning.png)
Make sure you have superuser (root) access rights to install the GStreamer SDK.

## Install GStreamer on Fedora

Run the following command:

```
dnf install gstreamer1-devel gstreamer1-plugins-base-tools gstreamer1-devel-docs gstreamer1-plugins-base-devel gstreamer1-plugins-base-devel-docs gstreamer1-plugins-good gstreamer1-plugins-good-extras gstreamer1-plugins-ugly gstreamer1-plugins-ugly-devel-docs  gstreamer1-plugins-bad-free gstreamer1-plugins-bad-free-devel gstreamer1-plugins-bad-free-extras
```

## Install GStreamre on Ubuntu or Debian

Run the following command:

` apt-get install .... `

## Building applications using GStreamer

The only other “development environment” that is required is
the `gcc` compiler and a text editor. In order to compile code that
requires the GStreamer SDK and uses the GStreamer core library, remember
to add this string to your `gcc` command:

```
pkg-config --cflags --libs gstreamer-1.0
```

If you're using other GStreamer libraries, e.g. the video library, you
have to add additional packages after gstreamer-1.0 in the above string
(gstreamer-video-1.0 for the video library, for example).

If your application is built with the help of libtool, e.g. when using
automake/autoconf as a build system, you have to run
the `configure` script from inside the `gst-sdk-shell` environment.

#### Getting the tutorial's source code

The source code for the tutorials can be copied and pasted from the
tutorial pages into a text file, but, for convenience, it is also available
in a GIT repository in the `tutorials` subdirectory.

The GIT repository can be cloned with:

```
git clone git://anongit.freedesktop.org/gstreamer/gst-docs
```

#### Building the tutorials

```
gcc basic-tutorial-1.c -o basic-tutorial-1 `pkg-config --cflags --libs gstreamer-1.0`
```

Using the file name of the tutorial you are interested in
(`basic-tutorial-1` in this example).

> ![Warning](images/icons/emoticons/warning.png) Depending on the GStreamer libraries you need to use, you will have to add more packages to the `pkg-config` command, besides `gstreamer-1.0`
> At the bottom of each tutorial's source code you will find the command for that specific tutorial, including the required libraries, in the required order.
> When developing your own applications, the GStreamer documentation will tell you what library a function belongs to.

#### Running the tutorials

To run the tutorials, simply execute the desired tutorial:

``` c
./basic-tutorial-1
```
Remove 'GStreamer SDK documentation' in all titles And pass all the markdown file into `git stripspace` 2016-05-27 02:21:04 +00:00			`# Installing on Linux`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Avoid having several 'h1' title per page Each page has one title and it looks better like that 2016-06-17 22:41:07 +00:00			`## Prerequisites`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`GStreamer is included in all Linux distributions. We recommend using the latest version of a fast moving distribution such as Fedora, Ubuntu (non-LTS), Debian sid or OpenSuse to get a recent GStreamer release.`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
			`All the commands given in this section are intended to be typed in from`
			`a terminal.`

Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`> ![Warning](images/icons/emoticons/warning.png)`
			`Make sure you have superuser (root) access rights to install the GStreamer SDK.`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`## Install GStreamer on Fedora`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`Run the following command:`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Fix comment block metadatas 2016-05-27 02:48:36 +00:00			```
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`dnf install gstreamer1-devel gstreamer1-plugins-base-tools gstreamer1-devel-docs gstreamer1-plugins-base-devel gstreamer1-plugins-base-devel-docs gstreamer1-plugins-good gstreamer1-plugins-good-extras gstreamer1-plugins-ugly gstreamer1-plugins-ugly-devel-docs gstreamer1-plugins-bad-free gstreamer1-plugins-bad-free-devel gstreamer1-plugins-bad-free-extras`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00			```

Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`## Install GStreamre on Ubuntu or Debian`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`Run the following command:`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			` apt-get install .... `
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`## Building applications using GStreamer`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
			`The only other “development environment” that is required is`
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			the `gcc` compiler and a text editor. In order to compile code that
Import initial automatic conversion 2016-05-16 14:30:34 +00:00			`requires the GStreamer SDK and uses the GStreamer core library, remember`
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			to add this string to your `gcc` command:
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Fix comment block metadatas 2016-05-27 02:48:36 +00:00			```
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`pkg-config --cflags --libs gstreamer-1.0`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00			```

			`If you're using other GStreamer libraries, e.g. the video library, you`
More removal of references to Gst 0.10 2016-05-27 18:49:41 +00:00			`have to add additional packages after gstreamer-1.0 in the above string`
			`(gstreamer-video-1.0 for the video library, for example).`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
			`If your application is built with the help of libtool, e.g. when using`
			`automake/autoconf as a build system, you have to run`
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			the `configure` script from inside the `gst-sdk-shell` environment.
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Avoid having several 'h1' title per page Each page has one title and it looks better like that 2016-06-17 22:41:07 +00:00			`#### Getting the tutorial's source code`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
			`The source code for the tutorials can be copied and pasted from the`
Replace references to installed tutorials Replace them with a link to gst-docs on cgit.freedesktop.org 2016-10-25 20:16:42 +00:00			`tutorial pages into a text file, but, for convenience, it is also available`
			in a GIT repository in the `tutorials` subdirectory.
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`The GIT repository can be cloned with:`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Fix comment block metadatas 2016-05-27 02:48:36 +00:00			```
Replace references to installed tutorials Replace them with a link to gst-docs on cgit.freedesktop.org 2016-10-25 20:16:42 +00:00			`git clone git://anongit.freedesktop.org/gstreamer/gst-docs`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00			```

Avoid having several 'h1' title per page Each page has one title and it looks better like that 2016-06-17 22:41:07 +00:00			`#### Building the tutorials`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Fix comment block metadatas 2016-05-27 02:48:36 +00:00			```
More removal of references to Gst 0.10 2016-05-27 18:49:41 +00:00			gcc basic-tutorial-1.c -o basic-tutorial-1 `pkg-config --cflags --libs gstreamer-1.0`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00			```

			`Using the file name of the tutorial you are interested in`
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			(`basic-tutorial-1` in this example).
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			> ![Warning](images/icons/emoticons/warning.png) Depending on the GStreamer libraries you need to use, you will have to add more packages to the `pkg-config` command, besides `gstreamer-1.0`
			`> At the bottom of each tutorial's source code you will find the command for that specific tutorial, including the required libraries, in the required order.`
			`> When developing your own applications, the GStreamer documentation will tell you what library a function belongs to.`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Avoid having several 'h1' title per page Each page has one title and it looks better like that 2016-06-17 22:41:07 +00:00			`#### Running the tutorials`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Update the installing on Linux page 2016-10-09 12:33:39 +00:00			`To run the tutorials, simply execute the desired tutorial:`
Import initial automatic conversion 2016-05-16 14:30:34 +00:00
Fix code block language tagging 2016-06-06 00:58:09 +00:00			``` c
Import initial automatic conversion 2016-05-16 14:30:34 +00:00			`./basic-tutorial-1`
			```