2 # ----------------------------------------------------------------------------
4 # create-uninstalled-setup.sh
6 # Little shell script that creates a fresh GStreamer uninstalled setup in
9 # This is the legacy uninstalled setup for autotools. There is also the
10 # gst-build module which provides the same using the meson build system.
12 # ----------------------------------------------------------------------------
14 # Copyright (C) 2011-2015 Tim-Philipp Müller <tim centricular net>
16 # This script is free software; you can redistribute it and/or
17 # modify it under the terms of the GNU Library General Public
18 # License as published by the Free Software Foundation; either
19 # version 2 of the License, or (at your option) any later version.
21 # This library is distributed in the hope that it will be useful,
22 # but WITHOUT ANY WARRANTY; without even the implied warranty of
23 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
24 # Library General Public License for more details.
26 # You should have received a copy of the GNU Library General Public
27 # License along with this library; if not, write to the
28 # Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
29 # Boston, MA 02110-1301, USA.
31 # ----------------------------------------------------------------------------
35 # set BRANCH to e.g. "1.2" to track the stable 1.2 branch instead of master
38 # set to "ssh" if you have a developer account and ssh access
42 #CLONE_OPTS="--depth=1 --no-single-branch"
44 # re-use and reference local master branch checkout if one already exists
45 # (saves network bandwidth)
46 REUSE_EXISTING_MASTER_CHECKOUT="true"
48 # git modules to clone
49 MODULES="gstreamer gst-plugins-base gst-plugins-good gst-plugins-ugly gst-plugins-bad gst-libav"
51 # note: we use ~/gst because that's what the gst-uninstalled script
52 # uses by default, so don't just change that to something else
53 UNINSTALLED_ROOT=~/gst
55 echo "==========================================================================================="
56 echo "Creating new GStreamer uninstalled environment for branch $BRANCH in $UNINSTALLED_ROOT ... "
57 echo "==========================================================================================="
59 mkdir -p $UNINSTALLED_ROOT
60 mkdir -p $UNINSTALLED_ROOT/$BRANCH
62 mkdir -p $UNINSTALLED_ROOT/$BRANCH/prefix
66 echo "Checking basic build tools and dependencies are installed..."
69 if ! pkg-config --version 2>/dev/null >/dev/null; then
71 elif ! pkg-config --exists glib-2.0 orc-0.4 2>/dev/null >/dev/null; then
73 elif ! bison --version 2>/dev/null >/dev/null; then
75 elif ! flex --version 2>/dev/null >/dev/null; then
77 elif ! git --version 2>/dev/null >/dev/null; then
83 if test "$DEPS_OK" != "yes"; then
84 echo "==========================================================================================="
86 echo " Some very basic build tools or dependencies are missing."
88 echo " Please install the following tools: pkg-config, bison, flex, git"
90 echo " and the following libraries: GLib (libglib2.0-dev or glib2-devel)"
91 echo " and Orc (liborc-0.4-dev or orc-devel)"
94 #echo " http://gstreamer.freedesktop.org/wiki/BuildDependenciesDebianUbuntu"
98 #echo " http://gstreamer.freedesktop.org/wiki/Fedora"
100 #echo " for instructions how to install them on Debian/Ubuntu-based systems."
102 echo "==========================================================================================="
107 cd $UNINSTALLED_ROOT/$BRANCH
112 if test "$BRANCH" != "master" \
113 -a "x$REUSE_EXISTING_MASTER_CHECKOUT" = "xtrue" \
114 -a -d ../master/$m; then
115 REF="--reference=../master/$m"
118 if test "$GIT_ACCESS" = "ssh"; then
119 git clone $CLONE_OPTS $REF git@gitlab.freedesktop.org:gstreamer/$m
121 git clone $CLONE_OPTS $REF https://gitlab.freedesktop.org/gstreamer/$m.git
125 if test "$BRANCH" != "master"; then
126 git checkout -b $BRANCH origin/$BRANCH
128 git submodule init && git submodule update
133 ln -s $BRANCH/gstreamer/scripts/gst-uninstalled gst-$BRANCH
138 echo "==========================================================================================="
140 echo "Done. Created new GStreamer uninstalled environment for branch $BRANCH in $UNINSTALLED_ROOT"
142 echo "To enter the uninstalled environment do: cd $UNINSTALLED_ROOT; ./gst-$BRANCH"
144 echo "To leave the uninstalled environment do: exit"
146 echo "To check the uninstalled environment do: printenv | grep GST"
147 echo " (loads of output = you're in the uninstalled environment)"
149 echo "==========================================================================================="
151 echo "Now compile all GStreamer modules one by one by first switching into"
152 echo "the uninstalled environment and then doing:"
154 echo " cd <MODULE>; ./autogen.sh; make"
156 echo "First gstreamer, then gst-plugins-base, then the other modules."
157 echo "You do not need to do 'make install'"
159 echo "==========================================================================================="
161 echo "If your system GLib is too old, you can install a newer version"
162 echo "into --prefix=$UNINSTALLED_ROOT/$BRANCH/prefix and it should be picked up"
163 echo "by autogen.sh/configure"
165 echo "==========================================================================================="