XiphWiki - User contributions [en]

GST cookbook/Trisquel6

2013-05-05T17:46:04Z

GChriss: line break

`#Every line in this page is executable in BASH. Have fun\!` 
`#Trisquel Release 6.0 (toutatis) GStreamer Build Instructions` 
`#Tested on a Lenovo x201i by GChriss / 15-April-2013` 
 
`#Prepare live USB key as documented:` 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
`#Boot USB key in BIOS -> Install to disk -> Manual partition` 
`#Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions` 
 
`#Run through install prompts and reboot` 
`#Works out-of-box: backlight, suspend, audio, USB, 10/100 Ethernet, graphics acceleration, Atheros AR5418 Wireless Network Adapter (168c:0024 -- BIOS modification required)` 
 
`#Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations` 
 
`#Open Terminal:` 
sudo su 
 
`#Get this stuff outta here...` 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get -y --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 pidgin-data gstreamer0.10-tools gnome-app-install 
 
apt-get -y update 
 
 echo "linux-image-generic hold" | dpkg --set-selections 
`#(To undo: echo "linux-image-generic install" | dpkg --set-selections )` 
apt-get -y dist-upgrade 
 
apt-get -y install bzip2 wget curl bison flex fakeroot vim mlocate subversion git-core openssh-server build-essential libtool intltool checkinstall autoconf automake kernel-package libasound2-dev libcanberra-gtk3-dev libffi-dev libfftw3-dev libgconf2-dev libglade2-dev libgnome-media-profiles-dev libgtkmm-3.0-dev libjson0-dev libncurses5-dev libqt3-mt-dev libsamplerate0-dev libsdl1.2-dev libsndfile1-dev libsoupcutter-dev libspeexdsp-dev libudev-dev libv4l-dev libxi-dev libxml2-dev libxmu-dev libxv-dev pciutils-dev cu sysfsutils gtk-doc-tools gnome-doc-utils iasl alsa-tools lm-sensors mkvtoolnix mkvtoolnix-gui cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools libfam-dev 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
`#Create this file and add the line that follows:` 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local `#--> add the following:` 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
`#Optional but helpful step for realtime audio processing` 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
`#'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y'` 
`#Consider adding Easycap: CONFIG_MEDIA_ANALOG_TV_SUPPORT=y + CONFIG_VIDEO_STK1160=m` 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
`#reboot and check for PREEMPT` 
uname -a |grep PREEMPT 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc `#-> add the following:` 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig:/packages/openvideopro/lib64/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages && wget "http://ftp.gnu.org/gnu/automake/automake-1.13.1.tar.gz" 
tar -xvzf automake-1.13.1.tar.gz && cd automake-1.13.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#YASM is optional:` 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
#vi /etc/security/limits.conf `#-> add the following line:` 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf `#-> create file with the following line:` 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss `#--> subsitute 'gchriss' for your username` 
exit 
 
`#At this point UI volume controls are missing/non-functional, but alsamixer works.` 
`#Build pulseaudio if needed, but otherwise optional:` 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
`#Also optional (but recommended):` 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
`#Optional:` 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#Optional:` 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
`#See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012` 
`#--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c'` 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
`#TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons)` 
`#TODO: The following builds but fails to connect to pulseaudio... debug needed?` 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
`#Open abrowser, download:` 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/glib/2.37/glib-2.37.0.tar.xz" 
tar -xvJf glib-2.37.0.tar.xz && cd glib-2.37.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
`#[all 'make check' tests pass]` 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://webm.googlecode.com/files/libvpx-v1.1.0.tar.bz2" 
tar -xvjf libvpx-v1.1.0.tar.bz2 && cd libvpx-v1.1.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#Optional but really helpful:` 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
`#Create the following block entries for automatic execution @ user login` 
`#The first two entries are specific to managing Thinkpad-series laptops` 
 
 
cat ~/.config/autostart/cpufreq-selector.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance"` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=cpu-freq-selector` 
`#Name=cpufreq-selector` 
`#Comment[en_US]=Set 2.4GHz (x4)` 
`#Comment=Set 2.4GHz (x4)` 
 
 
cat ~/.config/autostart/echo.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan"` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=Spin up x201i Fan` 
`#Name=Spin up x201i Fan` 
`#Comment[en_US]=Substitute 'disengaged' for '7' for max speed` 
`#Comment=Substitute 'disengaged' for '7' for max speed` 
 
 
cat ~/.config/autostart/gnome-terminal.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=gnome-terminal` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=GNOME Terminal` 
`#Name=GNOME Terminal` 
`#Comment[en_US]=Just to get things started...` 
`#Comment=Just to get things started...` 
 
 
cat ~/.config/autostart/qjackctl.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl"` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=qjackctl` 
`#Name=qjackctl` 
`#Comment[en_US]=Launch openvideopro qjackctl / -GChriss` 
`#Comment=Launch openvideopro qjackctl / -GChriss` 
 
 
sudo updatedb 
 
`#Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX` 
 
 
`#network-manager can sometimes be flaky, issue on an as-needed basis:` 
service network-manager restart 
 
 
`#Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so.` 
 
 
==Pidgin==
`#This section is for building Pidgin and Farsight from source.` 
`#Pidgin has XMMP videoconferencing abilities that may be helpful in a A/V production environment.` 
 
apt-get -y install cdbs dh-autoreconf dh-translations gir1.2-farstream-0.1 hardening-wrapper mercurial-git libavahi-glib-dev libdbus-glib-1-dev libenchant-dev libgadu3 libgadu-dev libgtkspell-dev libgtkspell-3-dev libidn11-dev libjson-glib-dev liblaunchpad-integration-dev libmeanwhile-dev libncursesw5-dev libnspr4-dev libnss3-dev libperl-dev libsasl2-dev libsqlite3-dev libstartup-notification0-dev libwebkitgtk-3.0-dev libxss-dev libzephyr-dev network-manager-dev python-dev python-gtk2-dev python-scour tcl tcl-dev tcl8.5 tcl8.5-dev tk tk-dev tk8.5 tk8.5-dev x11proto-scrnsaver-dev 
 
cd /packages 
wget http://gstreamer.freedesktop.org/src/gst-python/gst-python-0.10.22.tar.gz 
tar -xvzf gst-python-0.10.22.tar.gz && cd gst-python-0.10.22 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
wget "http://nice.freedesktop.org/releases/libnice-0.1.4.tar.gz" 
tar -xvzf libnice-0.1.4.tar.gz && cd libnice-0.1.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#[Skip the following two blocks if building Pidgin against GStreamer 1.0]` 
wget http://freedesktop.org/software/farstream/releases/farstream/farstream-0.1.2.tar.gz 
tar -xvzf farstream-0.1.2.tar && cd farstream-0.1.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
http://sourceforge.net/projects/pidgin/files/Pidgin/2.10.7/pidgin-2.10.7.tar.bz2 ==> download file 
cd /packages 
tar -xvjf pidgin-2.10.7.tar.bz2 && cd pidgin-2.10.7 
./configure --prefix=/packages/openvideopro --with-gstreamer=0.10 &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
`#[/skip]` 
 
 
`#[Experimental section; builds and launches but Pidgin<->GStreamer 1.0 lockups triggered on events...]` 
cd /packages 
wget "http://freedesktop.org/software/farstream/releases/farstream/farstream-0.2.3.tar.gz" 
tar -xvzf farstream-0.2.3.tar.gz && cd farstream-0.2.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
hg clone http://hg.pidgin.im/pidgin/main pidgin_1may2013 && cd pidgin_1may2013 
NOCONFIGURE=1 ./autogen.sh &>gsc_autogen.log 
GTK_LIBS='-L/packages/openvideopro/lib -lgstvideo-1.0' ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install
`#[/end experimental section]` 
 
 
 
 
==Totem==
apt-get -y install itstool libclutter-gst-dev libclutter-gtk-1.0-dev gsettings-desktop-schemas-dev libbonobo2-dev libgail-dev libxtst-dev libgmime-2.6-dev libsoup-gnome2.4-dev gobject-introspection libpeas-dev libvala-0.16-dev valac-0.16-vapi valac-0.16 pylint liblircclient-dev 
 
`#[Include support for non-libre standards implemented using free software...]` 
apt-get -y install libbz2-dev libcurl4-gnutls-dev libfaad-dev libmms-dev libgio2.0-cil-dev 
 
cd /packages && wget "http://downloads.xiph.org/releases/opus/opus-1.0.2.tar.gz" 
tar -xvzf opus-1.0.2.tar.gz && cd opus-1.0.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-bad/gst-plugins-bad-1.0.7.tar.xz" 
tar -xvJf gst-plugins-bad-1.0.7.tar.xz && cd gst-plugins-bad-1.0.7 
OPUS_CFLAGS='-I/packages/openvideopro/include' ./configure --enable-experimental --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/clutter-gst/2.0/clutter-gst-2.0.0.tar.xz" 
tar -xvJf clutter-gst-2.0.0.tar.xz && cd clutter-gst-2.0.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/atk/2.8/atk-2.8.0.tar.xz" 
tar -xvJf atk-2.8.0.tar.xz && cd atk-2.8.0 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget http://ftp.gnome.org/pub/GNOME/sources/at-spi2-core/2.8/at-spi2-core-2.8.0.tar.xz 
tar -xvJf at-spi2-core-2.8.0.tar.xz && cd at-spi2-core-2.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/at-spi2-atk/2.8/at-spi2-atk-2.8.1.tar.xz" 
tar -xvJf at-spi2-atk-2.8.1.tar.xz && cd at-spi2-atk-2.8.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/gtk+/3.6/gtk+-3.6.4.tar.xz" 
tar -xvJf gtk+-3.6.4.tar.xz && cd gtk+-3.6.4 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/gobject-introspection/1.36/gobject-introspection-1.36.0.tar.xz" 
tar -xvJf gobject-introspection-1.36.0.tar.xz && cd gobject-introspection-1.36.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://cairographics.org/releases/py2cairo-1.10.0.tar.bz2" 
tar -xvjf py2cairo-1.10.0.tar.bz2 && cd py2cairo-1.10.0 
./waf configure --prefix=/packages/openvideopro &>gsc_config.log 
./waf build &>gsc_build.log 
./waf install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/pygobject/3.9/pygobject-3.9.1.tar.xz" 
tar -xvJf pygobject-3.9.1.tar.xz && cd pygobject-3.9.1 
./configure --disable-glibtest --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/totem-pl-parser/3.4/totem-pl-parser-3.4.4.tar.xz" 
tar -xvJf totem-pl-parser-3.4.4.tar.xz && cd totem-pl-parser-3.4.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/grilo/0.2/grilo-0.2.5.tar.xz" 
tar -xvJf grilo-0.2.5.tar.xz && cd grilo-0.2.5 
./configure --disable-debug --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#[Optional extra Totem plugins]` 
sudo apt-get -y install libdconf-dbus-1-0 libgssdp-1.0-dev libgupnp-1.0-dev libgupnp-av-1.0-dev libgupnp-dlna-1.0-dev libdmapsharing-3.0-dev libgdata-dev libquvi-dev libtracker-sparql-0.14-dev 
wget "http://ftp.gnome.org/pub/GNOME/sources/grilo-plugins/0.2/grilo-plugins-0.2.6.tar.xz" 
tar -xvJf grilo-plugins-0.2.6.tar.xz && cd grilo-plugins-0.2.6 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
`#[TODO: Fix HTTP ('urisource-http') downloads]`
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/totem/3.8/totem-3.8.0.tar.xz" 
tar -xvJf totem-3.8.0.tar.xz && cd totem-3.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
 
cd 
totem & 
 
`#Launch Totem a few time to clear extraneous GStreamer plugin messages from being printed on the Terminal` 
==LightWorks (proprietary, tethered application)==
cd /packages 
wget "http://mirrors.us.kernel.org/ubuntu/pool/multiverse/n/nvidia-cg-toolkit/nvidia-cg-toolkit_3.0.0016-0ubuntu1_amd64.deb" 
wget "http://mirrors.us.kernel.org/ubuntu/pool/multiverse/n/nvidia-cg-toolkit/libcg_3.0.0016-0ubuntu1_amd64.deb" 
dpkg -i nvidia-cg-toolkit_3.0.0016-0ubuntu1_amd64.deb libcg_3.0.0016-0ubuntu1_amd64.deb 
apt-get -y install libportaudio2 libportaudiocpp0 libgsf-1-114 libgsf-1-common libjack-jackd2-0 
http://www.lwks.com/betas-linux --> Register, agree to terms of service, download lwks-11.1.H-amd64.deb 
dpkg -i lwks-11.1.H-amd64.deb 
lightworks &

GST cookbook/Trisquel6

2013-05-05T17:45:46Z

GChriss: add executable comments, hopefully helps w/ prepping for puppitization while maintaining manual-build readability

`#Every line in this page is executable in BASH. Have fun\!`
`#Trisquel Release 6.0 (toutatis) GStreamer Build Instructions` 
`#Tested on a Lenovo x201i by GChriss / 15-April-2013` 
 
`#Prepare live USB key as documented:` 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
`#Boot USB key in BIOS -> Install to disk -> Manual partition` 
`#Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions` 
 
`#Run through install prompts and reboot` 
`#Works out-of-box: backlight, suspend, audio, USB, 10/100 Ethernet, graphics acceleration, Atheros AR5418 Wireless Network Adapter (168c:0024 -- BIOS modification required)` 
 
`#Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations` 
 
`#Open Terminal:` 
sudo su 
 
`#Get this stuff outta here...` 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get -y --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 pidgin-data gstreamer0.10-tools gnome-app-install 
 
apt-get -y update 
 
 echo "linux-image-generic hold" | dpkg --set-selections 
`#(To undo: echo "linux-image-generic install" | dpkg --set-selections )` 
apt-get -y dist-upgrade 
 
apt-get -y install bzip2 wget curl bison flex fakeroot vim mlocate subversion git-core openssh-server build-essential libtool intltool checkinstall autoconf automake kernel-package libasound2-dev libcanberra-gtk3-dev libffi-dev libfftw3-dev libgconf2-dev libglade2-dev libgnome-media-profiles-dev libgtkmm-3.0-dev libjson0-dev libncurses5-dev libqt3-mt-dev libsamplerate0-dev libsdl1.2-dev libsndfile1-dev libsoupcutter-dev libspeexdsp-dev libudev-dev libv4l-dev libxi-dev libxml2-dev libxmu-dev libxv-dev pciutils-dev cu sysfsutils gtk-doc-tools gnome-doc-utils iasl alsa-tools lm-sensors mkvtoolnix mkvtoolnix-gui cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools libfam-dev 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
`#Create this file and add the line that follows:` 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local `#--> add the following:` 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
`#Optional but helpful step for realtime audio processing` 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
`#'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y'` 
`#Consider adding Easycap: CONFIG_MEDIA_ANALOG_TV_SUPPORT=y + CONFIG_VIDEO_STK1160=m` 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
`#reboot and check for PREEMPT` 
uname -a |grep PREEMPT 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc `#-> add the following:` 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig:/packages/openvideopro/lib64/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages && wget "http://ftp.gnu.org/gnu/automake/automake-1.13.1.tar.gz" 
tar -xvzf automake-1.13.1.tar.gz && cd automake-1.13.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#YASM is optional:` 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
#vi /etc/security/limits.conf `#-> add the following line:` 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf `#-> create file with the following line:` 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss `#--> subsitute 'gchriss' for your username` 
exit 
 
`#At this point UI volume controls are missing/non-functional, but alsamixer works.` 
`#Build pulseaudio if needed, but otherwise optional:` 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
`#Also optional (but recommended):` 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
`#Optional:` 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#Optional:` 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
`#See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012` 
`#--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c'` 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
`#TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons)` 
`#TODO: The following builds but fails to connect to pulseaudio... debug needed?` 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
`#Open abrowser, download:` 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/glib/2.37/glib-2.37.0.tar.xz" 
tar -xvJf glib-2.37.0.tar.xz && cd glib-2.37.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
`#[all 'make check' tests pass]` 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://webm.googlecode.com/files/libvpx-v1.1.0.tar.bz2" 
tar -xvjf libvpx-v1.1.0.tar.bz2 && cd libvpx-v1.1.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#Optional but really helpful:` 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
`#Create the following block entries for automatic execution @ user login` 
`#The first two entries are specific to managing Thinkpad-series laptops` 
 
 
cat ~/.config/autostart/cpufreq-selector.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance"` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=cpu-freq-selector` 
`#Name=cpufreq-selector` 
`#Comment[en_US]=Set 2.4GHz (x4)` 
`#Comment=Set 2.4GHz (x4)` 
 
 
cat ~/.config/autostart/echo.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan"` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=Spin up x201i Fan` 
`#Name=Spin up x201i Fan` 
`#Comment[en_US]=Substitute 'disengaged' for '7' for max speed` 
`#Comment=Substitute 'disengaged' for '7' for max speed` 
 
 
cat ~/.config/autostart/gnome-terminal.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=gnome-terminal` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=GNOME Terminal` 
`#Name=GNOME Terminal` 
`#Comment[en_US]=Just to get things started...` 
`#Comment=Just to get things started...` 
 
 
cat ~/.config/autostart/qjackctl.desktop 
 
`#[Desktop Entry]` 
`#Type=Application` 
`#Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl"` 
`#Hidden=false` 
`#NoDisplay=false` 
`#X-GNOME-Autostart-enabled=true` 
`#Name[en_US]=qjackctl` 
`#Name=qjackctl` 
`#Comment[en_US]=Launch openvideopro qjackctl / -GChriss` 
`#Comment=Launch openvideopro qjackctl / -GChriss` 
 
 
sudo updatedb 
 
`#Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX` 
 
 
`#network-manager can sometimes be flaky, issue on an as-needed basis:` 
service network-manager restart 
 
 
`#Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so.` 
 
 
==Pidgin==
`#This section is for building Pidgin and Farsight from source.` 
`#Pidgin has XMMP videoconferencing abilities that may be helpful in a A/V production environment.` 
 
apt-get -y install cdbs dh-autoreconf dh-translations gir1.2-farstream-0.1 hardening-wrapper mercurial-git libavahi-glib-dev libdbus-glib-1-dev libenchant-dev libgadu3 libgadu-dev libgtkspell-dev libgtkspell-3-dev libidn11-dev libjson-glib-dev liblaunchpad-integration-dev libmeanwhile-dev libncursesw5-dev libnspr4-dev libnss3-dev libperl-dev libsasl2-dev libsqlite3-dev libstartup-notification0-dev libwebkitgtk-3.0-dev libxss-dev libzephyr-dev network-manager-dev python-dev python-gtk2-dev python-scour tcl tcl-dev tcl8.5 tcl8.5-dev tk tk-dev tk8.5 tk8.5-dev x11proto-scrnsaver-dev 
 
cd /packages 
wget http://gstreamer.freedesktop.org/src/gst-python/gst-python-0.10.22.tar.gz 
tar -xvzf gst-python-0.10.22.tar.gz && cd gst-python-0.10.22 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
wget "http://nice.freedesktop.org/releases/libnice-0.1.4.tar.gz" 
tar -xvzf libnice-0.1.4.tar.gz && cd libnice-0.1.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#[Skip the following two blocks if building Pidgin against GStreamer 1.0]` 
wget http://freedesktop.org/software/farstream/releases/farstream/farstream-0.1.2.tar.gz 
tar -xvzf farstream-0.1.2.tar && cd farstream-0.1.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
http://sourceforge.net/projects/pidgin/files/Pidgin/2.10.7/pidgin-2.10.7.tar.bz2 ==> download file 
cd /packages 
tar -xvjf pidgin-2.10.7.tar.bz2 && cd pidgin-2.10.7 
./configure --prefix=/packages/openvideopro --with-gstreamer=0.10 &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
`#[/skip]` 
 
 
`#[Experimental section; builds and launches but Pidgin<->GStreamer 1.0 lockups triggered on events...]` 
cd /packages 
wget "http://freedesktop.org/software/farstream/releases/farstream/farstream-0.2.3.tar.gz" 
tar -xvzf farstream-0.2.3.tar.gz && cd farstream-0.2.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
hg clone http://hg.pidgin.im/pidgin/main pidgin_1may2013 && cd pidgin_1may2013 
NOCONFIGURE=1 ./autogen.sh &>gsc_autogen.log 
GTK_LIBS='-L/packages/openvideopro/lib -lgstvideo-1.0' ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install
`#[/end experimental section]` 
 
 
 
 
==Totem==
apt-get -y install itstool libclutter-gst-dev libclutter-gtk-1.0-dev gsettings-desktop-schemas-dev libbonobo2-dev libgail-dev libxtst-dev libgmime-2.6-dev libsoup-gnome2.4-dev gobject-introspection libpeas-dev libvala-0.16-dev valac-0.16-vapi valac-0.16 pylint liblircclient-dev 
 
`#[Include support for non-libre standards implemented using free software...]` 
apt-get -y install libbz2-dev libcurl4-gnutls-dev libfaad-dev libmms-dev libgio2.0-cil-dev 
 
cd /packages && wget "http://downloads.xiph.org/releases/opus/opus-1.0.2.tar.gz" 
tar -xvzf opus-1.0.2.tar.gz && cd opus-1.0.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-bad/gst-plugins-bad-1.0.7.tar.xz" 
tar -xvJf gst-plugins-bad-1.0.7.tar.xz && cd gst-plugins-bad-1.0.7 
OPUS_CFLAGS='-I/packages/openvideopro/include' ./configure --enable-experimental --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/clutter-gst/2.0/clutter-gst-2.0.0.tar.xz" 
tar -xvJf clutter-gst-2.0.0.tar.xz && cd clutter-gst-2.0.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/atk/2.8/atk-2.8.0.tar.xz" 
tar -xvJf atk-2.8.0.tar.xz && cd atk-2.8.0 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget http://ftp.gnome.org/pub/GNOME/sources/at-spi2-core/2.8/at-spi2-core-2.8.0.tar.xz 
tar -xvJf at-spi2-core-2.8.0.tar.xz && cd at-spi2-core-2.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/at-spi2-atk/2.8/at-spi2-atk-2.8.1.tar.xz" 
tar -xvJf at-spi2-atk-2.8.1.tar.xz && cd at-spi2-atk-2.8.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/gtk+/3.6/gtk+-3.6.4.tar.xz" 
tar -xvJf gtk+-3.6.4.tar.xz && cd gtk+-3.6.4 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/gobject-introspection/1.36/gobject-introspection-1.36.0.tar.xz" 
tar -xvJf gobject-introspection-1.36.0.tar.xz && cd gobject-introspection-1.36.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://cairographics.org/releases/py2cairo-1.10.0.tar.bz2" 
tar -xvjf py2cairo-1.10.0.tar.bz2 && cd py2cairo-1.10.0 
./waf configure --prefix=/packages/openvideopro &>gsc_config.log 
./waf build &>gsc_build.log 
./waf install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/pygobject/3.9/pygobject-3.9.1.tar.xz" 
tar -xvJf pygobject-3.9.1.tar.xz && cd pygobject-3.9.1 
./configure --disable-glibtest --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/totem-pl-parser/3.4/totem-pl-parser-3.4.4.tar.xz" 
tar -xvJf totem-pl-parser-3.4.4.tar.xz && cd totem-pl-parser-3.4.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/grilo/0.2/grilo-0.2.5.tar.xz" 
tar -xvJf grilo-0.2.5.tar.xz && cd grilo-0.2.5 
./configure --disable-debug --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
`#[Optional extra Totem plugins]` 
sudo apt-get -y install libdconf-dbus-1-0 libgssdp-1.0-dev libgupnp-1.0-dev libgupnp-av-1.0-dev libgupnp-dlna-1.0-dev libdmapsharing-3.0-dev libgdata-dev libquvi-dev libtracker-sparql-0.14-dev 
wget "http://ftp.gnome.org/pub/GNOME/sources/grilo-plugins/0.2/grilo-plugins-0.2.6.tar.xz" 
tar -xvJf grilo-plugins-0.2.6.tar.xz && cd grilo-plugins-0.2.6 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
`#[TODO: Fix HTTP ('urisource-http') downloads]`
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/totem/3.8/totem-3.8.0.tar.xz" 
tar -xvJf totem-3.8.0.tar.xz && cd totem-3.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
 
cd 
totem & 
 
`#Launch Totem a few time to clear extraneous GStreamer plugin messages from being printed on the Terminal` 
==LightWorks (proprietary, tethered application)==
cd /packages 
wget "http://mirrors.us.kernel.org/ubuntu/pool/multiverse/n/nvidia-cg-toolkit/nvidia-cg-toolkit_3.0.0016-0ubuntu1_amd64.deb" 
wget "http://mirrors.us.kernel.org/ubuntu/pool/multiverse/n/nvidia-cg-toolkit/libcg_3.0.0016-0ubuntu1_amd64.deb" 
dpkg -i nvidia-cg-toolkit_3.0.0016-0ubuntu1_amd64.deb libcg_3.0.0016-0ubuntu1_amd64.deb 
apt-get -y install libportaudio2 libportaudiocpp0 libgsf-1-114 libgsf-1-common libjack-jackd2-0 
http://www.lwks.com/betas-linux --> Register, agree to terms of service, download lwks-11.1.H-amd64.deb 
dpkg -i lwks-11.1.H-amd64.deb 
lightworks &

GST cookbook/Trisquel6

2013-05-05T17:22:43Z

GChriss: +libsoupcutter-dev + WebM + LightWorks

Trisquel Release 6.0 (toutatis) GStreamer Build Instructions 
Tested on a Lenovo x201i by GChriss / 15-April-2013 
 
Prepare live USB key as documented: 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
Boot USB key in BIOS -> Install to disk -> Manual partition 
Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions 
 
Run through install prompts and reboot 
Works out-of-box: backlight, suspend, audio, USB, 10/100 Ethernet, graphics acceleration, Atheros AR5418 Wireless Network Adapter (168c:0024 -- BIOS modification required) 
 
Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations 
 
Open Terminal: 
sudo su 
 
Get this stuff outta here... 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 pidgin-data gstreamer0.10-tools gnome-app-install 
 
apt-get update 
 
 echo "linux-image-generic hold" | dpkg --set-selections 
(To undo: echo "linux-image-generic install" | dpkg --set-selections ) 
apt-get dist-upgrade 
 
apt-get install bzip2 wget curl bison flex fakeroot vim mlocate subversion git-core openssh-server build-essential libtool intltool checkinstall autoconf automake kernel-package libasound2-dev libcanberra-gtk3-dev libffi-dev libfftw3-dev libgconf2-dev libglade2-dev libgnome-media-profiles-dev libgtkmm-3.0-dev libjson0-dev libncurses5-dev libqt3-mt-dev libsamplerate0-dev libsdl1.2-dev libsndfile1-dev libsoupcutter-dev libspeexdsp-dev libudev-dev libv4l-dev libxi-dev libxml2-dev libxmu-dev libxv-dev pciutils-dev cu sysfsutils gtk-doc-tools gnome-doc-utils iasl alsa-tools lm-sensors mkvtoolnix mkvtoolnix-gui cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools libfam-dev 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
Create this file and add the line that follows: 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local --> add the following: 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
Optional but helpful step for realtime audio processing 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y' 
Consider adding Easycap: CONFIG_MEDIA_ANALOG_TV_SUPPORT=y + CONFIG_VIDEO_STK1160=m 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
reboot and check for PREEMPT in 'uname -a': 
Linux x201 3.8.6-gnu #1 SMP PREEMPT Sat Apr 13 02:07:48 EDT 2013 x86_64 x86_64 x86_64 GNU/Linux 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc -> add the following: 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig:/packages/openvideopro/lib64/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages && wget "http://ftp.gnu.org/gnu/automake/automake-1.13.1.tar.gz" 
tar -xvzf automake-1.13.1.tar.gz && cd automake-1.13.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
YASM is optional: 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
vi /etc/security/limits.conf -> add the following line: 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf -> create file with the following line: 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss --> subsitute 'gchriss' for your username 
exit 
 
At this point UI volume controls are missing/non-functional, but alsamixer works. 
Build pulseaudio if needed, but otherwise optional: 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
Also optional (but recommended): 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012 
--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c' 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons) 
TODO: The following builds but fails to connect to pulseaudio... debug needed? 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Rebuild Totem + PiTiVi 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
Open abrowser, download: 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/glib/2.37/glib-2.37.0.tar.xz" 
tar -xvJf glib-2.37.0.tar.xz && cd glib-2.37.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
[all 'make check' tests pass] 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://webm.googlecode.com/files/libvpx-v1.1.0.tar.bz2" 
tar -xvjf libvpx-v1.1.0.tar.bz2 && cd libvpx-v1.1.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional but really helpful: 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
=== 
Create the following block entries for automatic execution @ user login 
The first two entries are specific to managing Thinkpad-series laptops 
 
 
gsc@host:~$ cat ~/.config/autostart/cpufreq-selector.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=cpu-freq-selector 
Name=cpufreq-selector 
Comment[en_US]=Set 2.4GHz (x4) 
Comment=Set 2.4GHz (x4) 
 
 
gsc@host:~$ cat ~/.config/autostart/echo.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=Spin up x201i Fan 
Name=Spin up x201i Fan 
Comment[en_US]=Substitute 'disengaged' for '7' for max speed 
Comment=Substitute 'disengaged' for '7' for max speed 
 
 
gsc@host:~$ cat ~/.config/autostart/gnome-terminal.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=gnome-terminal 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=GNOME Terminal 
Name=GNOME Terminal 
Comment[en_US]=Just to get things started... 
Comment=Just to get things started... 
 
 
gsc@host:~$ cat ~/.config/autostart/qjackctl.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=qjackctl 
Name=qjackctl 
Comment[en_US]=Launch openvideopro qjackctl / -GChriss 
Comment=Launch openvideopro qjackctl / -GChriss 
 
=== 
 
 
sudo updatedb 
 
Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX 
 
 
network-manager can sometimes be flaky, issue on an as-needed basis: 
service network-manager restart 
 
 
Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so. 
 
 
==Pidgin==
This section is for building Pidgin and Farsight from source. 
Pidgin has XMMP videoconferencing abilities that may be helpful in a A/V production environment. 
 
apt-get install cdbs dh-autoreconf dh-translations gir1.2-farstream-0.1 hardening-wrapper mercurial-git libavahi-glib-dev libdbus-glib-1-dev libenchant-dev libgadu3 libgadu-dev libgtkspell-dev libgtkspell-3-dev libidn11-dev libjson-glib-dev liblaunchpad-integration-dev libmeanwhile-dev libncursesw5-dev libnspr4-dev libnss3-dev libperl-dev libsasl2-dev libsqlite3-dev libstartup-notification0-dev libwebkitgtk-3.0-dev libxss-dev libzephyr-dev network-manager-dev python-dev python-gtk2-dev python-scour tcl tcl-dev tcl8.5 tcl8.5-dev tk tk-dev tk8.5 tk8.5-dev x11proto-scrnsaver-dev 
 
cd /packages 
wget http://gstreamer.freedesktop.org/src/gst-python/gst-python-0.10.22.tar.gz 
tar -xvzf gst-python-0.10.22.tar.gz && cd gst-python-0.10.22 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
wget "http://nice.freedesktop.org/releases/libnice-0.1.4.tar.gz" 
tar -xvzf libnice-0.1.4.tar.gz && cd libnice-0.1.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Skip the following two blocks if building Pidgin against GStreamer 1.0] 
wget http://freedesktop.org/software/farstream/releases/farstream/farstream-0.1.2.tar.gz 
tar -xvzf farstream-0.1.2.tar && cd farstream-0.1.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
http://sourceforge.net/projects/pidgin/files/Pidgin/2.10.7/pidgin-2.10.7.tar.bz2 ==> download file 
cd /packages 
tar -xvjf pidgin-2.10.7.tar.bz2 && cd pidgin-2.10.7 
./configure --prefix=/packages/openvideopro --with-gstreamer=0.10 &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
[/skip] 
 
 
[Experimental section; builds and launches but Pidgin<->GStreamer 1.0 lockups triggered on events...] 
cd /packages 
wget "http://freedesktop.org/software/farstream/releases/farstream/farstream-0.2.3.tar.gz" 
tar -xvzf farstream-0.2.3.tar.gz && cd farstream-0.2.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
hg clone http://hg.pidgin.im/pidgin/main pidgin_1may2013 && cd pidgin_1may2013 
NOCONFIGURE=1 ./autogen.sh &>gsc_autogen.log 
GTK_LIBS='-L/packages/openvideopro/lib -lgstvideo-1.0' ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install
[/end experimental section] 
 
 
 
 
==Totem==
apt-get install itstool libclutter-gst-dev libclutter-gtk-1.0-dev gsettings-desktop-schemas-dev libbonobo2-dev libgail-dev libxtst-dev libgmime-2.6-dev libsoup-gnome2.4-dev gobject-introspection libpeas-dev libvala-0.16-dev valac-0.16-vapi valac-0.16 pylint liblircclient-dev 
 
[Include support for non-libre standards implemented using free software...] 
apt-get install libbz2-dev libcurl4-gnutls-dev libfaad-dev libmms-dev libgio2.0-cil-dev 
 
cd /packages && wget "http://downloads.xiph.org/releases/opus/opus-1.0.2.tar.gz" 
tar -xvzf opus-1.0.2.tar.gz && cd opus-1.0.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-bad/gst-plugins-bad-1.0.7.tar.xz" 
tar -xvJf gst-plugins-bad-1.0.7.tar.xz && cd gst-plugins-bad-1.0.7 
OPUS_CFLAGS='-I/packages/openvideopro/include' ./configure --enable-experimental --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/clutter-gst/2.0/clutter-gst-2.0.0.tar.xz" 
tar -xvJf clutter-gst-2.0.0.tar.xz && cd clutter-gst-2.0.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/atk/2.8/atk-2.8.0.tar.xz" 
tar -xvJf atk-2.8.0.tar.xz && cd atk-2.8.0 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget http://ftp.gnome.org/pub/GNOME/sources/at-spi2-core/2.8/at-spi2-core-2.8.0.tar.xz 
tar -xvJf at-spi2-core-2.8.0.tar.xz && cd at-spi2-core-2.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/at-spi2-atk/2.8/at-spi2-atk-2.8.1.tar.xz" 
tar -xvJf at-spi2-atk-2.8.1.tar.xz && cd at-spi2-atk-2.8.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/gtk+/3.6/gtk+-3.6.4.tar.xz" 
tar -xvJf gtk+-3.6.4.tar.xz && cd gtk+-3.6.4 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/gobject-introspection/1.36/gobject-introspection-1.36.0.tar.xz" 
tar -xvJf gobject-introspection-1.36.0.tar.xz && cd gobject-introspection-1.36.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://cairographics.org/releases/py2cairo-1.10.0.tar.bz2" 
tar -xvjf py2cairo-1.10.0.tar.bz2 && cd py2cairo-1.10.0 
./waf configure --prefix=/packages/openvideopro &>gsc_config.log 
./waf build &>gsc_build.log 
./waf install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/pygobject/3.9/pygobject-3.9.1.tar.xz" 
tar -xvJf pygobject-3.9.1.tar.xz && cd pygobject-3.9.1 
./configure --disable-glibtest --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/totem-pl-parser/3.4/totem-pl-parser-3.4.4.tar.xz" 
tar -xvJf totem-pl-parser-3.4.4.tar.xz && cd totem-pl-parser-3.4.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/grilo/0.2/grilo-0.2.5.tar.xz" 
tar -xvJf grilo-0.2.5.tar.xz && cd grilo-0.2.5 
./configure --disable-debug --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Optional extra Totem plugins] 
sudo apt-get install libdconf-dbus-1-0 libgssdp-1.0-dev libgupnp-1.0-dev libgupnp-av-1.0-dev libgupnp-dlna-1.0-dev libdmapsharing-3.0-dev libgdata-dev libquvi-dev libtracker-sparql-0.14-dev 
wget "http://ftp.gnome.org/pub/GNOME/sources/grilo-plugins/0.2/grilo-plugins-0.2.6.tar.xz" 
tar -xvJf grilo-plugins-0.2.6.tar.xz && cd grilo-plugins-0.2.6 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
[TODO: Fix HTTP ('urisource-http') downloads]
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/totem/3.8/totem-3.8.0.tar.xz" 
tar -xvJf totem-3.8.0.tar.xz && cd totem-3.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
 
cd 
totem & 
 
Launch Totem a few time to clear extraneous GStreamer plugin messages from being printed on the Terminal 
==LightWorks (proprietary, tethered application)==
cd /packages 
wget "http://mirrors.us.kernel.org/ubuntu/pool/multiverse/n/nvidia-cg-toolkit/nvidia-cg-toolkit_3.0.0016-0ubuntu1_amd64.deb" 
wget "http://mirrors.us.kernel.org/ubuntu/pool/multiverse/n/nvidia-cg-toolkit/libcg_3.0.0016-0ubuntu1_amd64.deb" 
dpkg -i nvidia-cg-toolkit_3.0.0016-0ubuntu1_amd64.deb libcg_3.0.0016-0ubuntu1_amd64.deb 
apt-get install libportaudio2 libportaudiocpp0 libgsf-1-114 libgsf-1-common libjack-jackd2-0 
http://www.lwks.com/betas-linux --> Register, agree to terms of service, download lwks-11.1.H-amd64.deb 
dpkg -i lwks-11.1.H-amd64.deb 
lightworks &

GST cookbook/Trisquel6

2013-05-04T17:16:47Z

GChriss: /* Totem */ add grilo plugins

Trisquel Release 6.0 (toutatis) GStreamer Build Instructions 
Tested on a Lenovo x201i by GChriss / 15-April-2013 
 
Prepare live USB key as documented: 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
Boot USB key in BIOS -> Install to disk -> Manual partition 
Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions 
 
Run through install prompts and reboot 
Works out-of-box: backlight, suspend, audio, USB, 10/100 Ethernet, graphics acceleration, Atheros AR5418 Wireless Network Adapter (168c:0024 -- BIOS modification required) 
 
Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations 
 
Open Terminal: 
sudo su 
 
Get this stuff outta here... 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 pidgin-data gstreamer0.10-tools gnome-app-install 
 
apt-get update 
 
 echo "linux-image-generic hold" | dpkg --set-selections 
(To undo: echo "linux-image-generic install" | dpkg --set-selections ) 
apt-get dist-upgrade 
 
apt-get install bzip2 wget curl bison flex fakeroot vim mlocate subversion git-core openssh-server build-essential libtool intltool checkinstall autoconf automake kernel-package libasound2-dev libcanberra-gtk3-dev libffi-dev libfftw3-dev libgconf2-dev libglade2-dev libgnome-media-profiles-dev libgtkmm-3.0-dev libjson0-dev libncurses5-dev libqt3-mt-dev libsamplerate0-dev libsdl1.2-dev libsndfile1-dev libspeexdsp-dev libudev-dev libv4l-dev libxi-dev libxml2-dev libxmu-dev libxv-dev pciutils-dev cu sysfsutils gtk-doc-tools gnome-doc-utils iasl alsa-tools lm-sensors mkvtoolnix mkvtoolnix-gui cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools libfam-dev 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
Create this file and add the line that follows: 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local --> add the following: 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
Optional but helpful step for realtime audio processing 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y' 
Consider adding Easycap: CONFIG_MEDIA_ANALOG_TV_SUPPORT=y + CONFIG_VIDEO_STK1160=m 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
reboot and check for PREEMPT in 'uname -a': 
Linux x201 3.8.6-gnu #1 SMP PREEMPT Sat Apr 13 02:07:48 EDT 2013 x86_64 x86_64 x86_64 GNU/Linux 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc -> add the following: 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig:/packages/openvideopro/lib64/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages && wget "http://ftp.gnu.org/gnu/automake/automake-1.13.1.tar.gz" 
tar -xvzf automake-1.13.1.tar.gz && cd automake-1.13.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
YASM is optional: 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
vi /etc/security/limits.conf -> add the following line: 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf -> create file with the following line: 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss --> subsitute 'gchriss' for your username 
exit 
 
At this point UI volume controls are missing/non-functional, but alsamixer works. 
Build pulseaudio if needed, but otherwise optional: 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
Also optional (but recommended): 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012 
--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c' 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons) 
TODO: The following builds but fails to connect to pulseaudio... debug needed? 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Rebuild Totem + PiTiVi 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
Open abrowser, download: 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/glib/2.37/glib-2.37.0.tar.xz" 
tar -xvJf glib-2.37.0.tar.xz && cd glib-2.37.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
[all 'make check' tests pass] 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional but really helpful: 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
=== 
Create the following block entries for automatic execution @ user login 
The first two entries are specific to managing Thinkpad-series laptops 
 
 
gsc@host:~$ cat ~/.config/autostart/cpufreq-selector.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=cpu-freq-selector 
Name=cpufreq-selector 
Comment[en_US]=Set 2.4GHz (x4) 
Comment=Set 2.4GHz (x4) 
 
 
gsc@host:~$ cat ~/.config/autostart/echo.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=Spin up x201i Fan 
Name=Spin up x201i Fan 
Comment[en_US]=Substitute 'disengaged' for '7' for max speed 
Comment=Substitute 'disengaged' for '7' for max speed 
 
 
gsc@host:~$ cat ~/.config/autostart/gnome-terminal.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=gnome-terminal 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=GNOME Terminal 
Name=GNOME Terminal 
Comment[en_US]=Just to get things started... 
Comment=Just to get things started... 
 
 
gsc@host:~$ cat ~/.config/autostart/qjackctl.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=qjackctl 
Name=qjackctl 
Comment[en_US]=Launch openvideopro qjackctl / -GChriss 
Comment=Launch openvideopro qjackctl / -GChriss 
 
=== 
 
 
sudo updatedb 
 
Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX 
 
 
network-manager can sometimes be flaky, issue on an as-needed basis: 
service network-manager restart 
 
 
Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so. 
 
 
==Pidgin==
This section is for building Pidgin and Farsight from source. 
Pidgin has XMMP videoconferencing abilities that may be helpful in a A/V production environment. 
 
apt-get install cdbs dh-autoreconf dh-translations gir1.2-farstream-0.1 hardening-wrapper mercurial-git libavahi-glib-dev libdbus-glib-1-dev libenchant-dev libgadu3 libgadu-dev libgtkspell-dev libgtkspell-3-dev libidn11-dev libjson-glib-dev liblaunchpad-integration-dev libmeanwhile-dev libncursesw5-dev libnspr4-dev libnss3-dev libperl-dev libsasl2-dev libsqlite3-dev libstartup-notification0-dev libwebkitgtk-3.0-dev libxss-dev libzephyr-dev network-manager-dev python-dev python-gtk2-dev python-scour tcl tcl-dev tcl8.5 tcl8.5-dev tk tk-dev tk8.5 tk8.5-dev x11proto-scrnsaver-dev 
 
cd /packages 
wget http://gstreamer.freedesktop.org/src/gst-python/gst-python-0.10.22.tar.gz 
tar -xvzf gst-python-0.10.22.tar.gz && cd gst-python-0.10.22 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
wget "http://nice.freedesktop.org/releases/libnice-0.1.4.tar.gz" 
tar -xvzf libnice-0.1.4.tar.gz && cd libnice-0.1.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Skip the following two blocks if building Pidgin against GStreamer 1.0] 
wget http://freedesktop.org/software/farstream/releases/farstream/farstream-0.1.2.tar.gz 
tar -xvzf farstream-0.1.2.tar && cd farstream-0.1.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
http://sourceforge.net/projects/pidgin/files/Pidgin/2.10.7/pidgin-2.10.7.tar.bz2 ==> download file 
cd /packages 
tar -xvjf pidgin-2.10.7.tar.bz2 && cd pidgin-2.10.7 
./configure --prefix=/packages/openvideopro --with-gstreamer=0.10 &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
[/skip] 
 
 
[Experimental section; builds and launches but Pidgin<->GStreamer 1.0 lockups triggered on events...] 
cd /packages 
wget "http://freedesktop.org/software/farstream/releases/farstream/farstream-0.2.3.tar.gz" 
tar -xvzf farstream-0.2.3.tar.gz && cd farstream-0.2.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
hg clone http://hg.pidgin.im/pidgin/main pidgin_1may2013 && cd pidgin_1may2013 
NOCONFIGURE=1 ./autogen.sh &>gsc_autogen.log 
GTK_LIBS='-L/packages/openvideopro/lib -lgstvideo-1.0' ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install
[/end experimental section] 
 
 
 
 
==Totem==
apt-get install itstool libclutter-gst-dev libclutter-gtk-1.0-dev gsettings-desktop-schemas-dev libbonobo2-dev libgail-dev libxtst-dev libgmime-2.6-dev libsoup-gnome2.4-dev gobject-introspection libpeas-dev libvala-0.16-dev valac-0.16-vapi valac-0.16 pylint liblircclient-dev 
 
[Include support for non-libre standards implemented using free software...] 
apt-get install libbz2-dev libcurl4-gnutls-dev libfaad-dev libmms-dev libgio2.0-cil-dev 
 
cd /packages && wget "http://downloads.xiph.org/releases/opus/opus-1.0.2.tar.gz" 
tar -xvzf opus-1.0.2.tar.gz && cd opus-1.0.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-bad/gst-plugins-bad-1.0.7.tar.xz" 
tar -xvJf gst-plugins-bad-1.0.7.tar.xz && cd gst-plugins-bad-1.0.7 
OPUS_CFLAGS='-I/packages/openvideopro/include' ./configure --enable-experimental --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/clutter-gst/2.0/clutter-gst-2.0.0.tar.xz" 
tar -xvJf clutter-gst-2.0.0.tar.xz && cd clutter-gst-2.0.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/atk/2.8/atk-2.8.0.tar.xz" 
tar -xvJf atk-2.8.0.tar.xz && cd atk-2.8.0 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget http://ftp.gnome.org/pub/GNOME/sources/at-spi2-core/2.8/at-spi2-core-2.8.0.tar.xz 
tar -xvJf at-spi2-core-2.8.0.tar.xz && cd at-spi2-core-2.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/at-spi2-atk/2.8/at-spi2-atk-2.8.1.tar.xz" 
tar -xvJf at-spi2-atk-2.8.1.tar.xz && cd at-spi2-atk-2.8.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/gtk+/3.6/gtk+-3.6.4.tar.xz" 
tar -xvJf gtk+-3.6.4.tar.xz && cd gtk+-3.6.4 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/gobject-introspection/1.36/gobject-introspection-1.36.0.tar.xz" 
tar -xvJf gobject-introspection-1.36.0.tar.xz && cd gobject-introspection-1.36.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://cairographics.org/releases/py2cairo-1.10.0.tar.bz2" 
tar -xvjf py2cairo-1.10.0.tar.bz2 && cd py2cairo-1.10.0 
./waf configure --prefix=/packages/openvideopro &>gsc_config.log 
./waf build &>gsc_build.log 
./waf install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/pygobject/3.9/pygobject-3.9.1.tar.xz" 
tar -xvJf pygobject-3.9.1.tar.xz && cd pygobject-3.9.1 
./configure --disable-glibtest --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/totem-pl-parser/3.4/totem-pl-parser-3.4.4.tar.xz" 
tar -xvJf totem-pl-parser-3.4.4.tar.xz && cd totem-pl-parser-3.4.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/grilo/0.2/grilo-0.2.5.tar.xz" 
tar -xvJf grilo-0.2.5.tar.xz && cd grilo-0.2.5 
./configure --disable-debug --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Optional extra Totem plugins] 
sudo apt-get install libdconf-dbus-1-0 libgssdp-1.0-dev libgupnp-1.0-dev libgupnp-av-1.0-dev libgupnp-dlna-1.0-dev libdmapsharing-3.0-dev libgdata-dev libquvi-dev libtracker-sparql-0.14-dev 
wget "http://ftp.gnome.org/pub/GNOME/sources/grilo-plugins/0.2/grilo-plugins-0.2.6.tar.xz" 
tar -xvJf grilo-plugins-0.2.6.tar.xz && cd grilo-plugins-0.2.6 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
[TODO: Fix HTTP ('urisource-http') downloads]
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/totem/3.8/totem-3.8.0.tar.xz" 
tar -xvJf totem-3.8.0.tar.xz && cd totem-3.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
 
cd 
totem & 
 
Launch Totem a few time to clear extraneous GStreamer plugin messages from being printed on the Terminal

GST cookbook/Trisquel6

2013-05-04T07:14:46Z

GChriss: add first-past Totem instructions + edits to main build instructions. Totem works just fine, if not a little rough on edges

Trisquel Release 6.0 (toutatis) GStreamer Build Instructions 
Tested on a Lenovo x201i by GChriss / 15-April-2013 
 
Prepare live USB key as documented: 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
Boot USB key in BIOS -> Install to disk -> Manual partition 
Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions 
 
Run through install prompts and reboot 
Works out-of-box: backlight, suspend, audio, USB, 10/100 Ethernet, graphics acceleration, Atheros AR5418 Wireless Network Adapter (168c:0024 -- BIOS modification required) 
 
Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations 
 
Open Terminal: 
sudo su 
 
Get this stuff outta here... 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 pidgin-data gstreamer0.10-tools gnome-app-install 
 
apt-get update 
 
 echo "linux-image-generic hold" | dpkg --set-selections 
(To undo: echo "linux-image-generic install" | dpkg --set-selections ) 
apt-get dist-upgrade 
 
apt-get install bzip2 wget curl bison flex fakeroot vim mlocate subversion git-core openssh-server build-essential libtool intltool checkinstall autoconf automake kernel-package libasound2-dev libcanberra-gtk3-dev libffi-dev libfftw3-dev libgconf2-dev libglade2-dev libgnome-media-profiles-dev libgtkmm-3.0-dev libjson0-dev libncurses5-dev libqt3-mt-dev libsamplerate0-dev libsdl1.2-dev libsndfile1-dev libspeexdsp-dev libudev-dev libv4l-dev libxi-dev libxml2-dev libxmu-dev libxv-dev pciutils-dev cu sysfsutils gtk-doc-tools gnome-doc-utils iasl alsa-tools lm-sensors mkvtoolnix mkvtoolnix-gui cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools libfam-dev 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
Create this file and add the line that follows: 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local --> add the following: 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
Optional but helpful step for realtime audio processing 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y' 
Consider adding Easycap: CONFIG_MEDIA_ANALOG_TV_SUPPORT=y + CONFIG_VIDEO_STK1160=m 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
reboot and check for PREEMPT in 'uname -a': 
Linux x201 3.8.6-gnu #1 SMP PREEMPT Sat Apr 13 02:07:48 EDT 2013 x86_64 x86_64 x86_64 GNU/Linux 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc -> add the following: 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig:/packages/openvideopro/lib64/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages && wget "http://ftp.gnu.org/gnu/automake/automake-1.13.1.tar.gz" 
tar -xvzf automake-1.13.1.tar.gz && cd automake-1.13.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
YASM is optional: 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
vi /etc/security/limits.conf -> add the following line: 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf -> create file with the following line: 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss --> subsitute 'gchriss' for your username 
exit 
 
At this point UI volume controls are missing/non-functional, but alsamixer works. 
Build pulseaudio if needed, but otherwise optional: 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
Also optional (but recommended): 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012 
--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c' 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons) 
TODO: The following builds but fails to connect to pulseaudio... debug needed? 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Rebuild Totem + PiTiVi 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
Open abrowser, download: 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/glib/2.37/glib-2.37.0.tar.xz" 
tar -xvJf glib-2.37.0.tar.xz && cd glib-2.37.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
[all 'make check' tests pass] 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional but really helpful: 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
=== 
Create the following block entries for automatic execution @ user login 
The first two entries are specific to managing Thinkpad-series laptops 
 
 
gsc@host:~$ cat ~/.config/autostart/cpufreq-selector.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=cpu-freq-selector 
Name=cpufreq-selector 
Comment[en_US]=Set 2.4GHz (x4) 
Comment=Set 2.4GHz (x4) 
 
 
gsc@host:~$ cat ~/.config/autostart/echo.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=Spin up x201i Fan 
Name=Spin up x201i Fan 
Comment[en_US]=Substitute 'disengaged' for '7' for max speed 
Comment=Substitute 'disengaged' for '7' for max speed 
 
 
gsc@host:~$ cat ~/.config/autostart/gnome-terminal.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=gnome-terminal 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=GNOME Terminal 
Name=GNOME Terminal 
Comment[en_US]=Just to get things started... 
Comment=Just to get things started... 
 
 
gsc@host:~$ cat ~/.config/autostart/qjackctl.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=qjackctl 
Name=qjackctl 
Comment[en_US]=Launch openvideopro qjackctl / -GChriss 
Comment=Launch openvideopro qjackctl / -GChriss 
 
=== 
 
 
sudo updatedb 
 
Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX 
 
 
network-manager can sometimes be flaky, issue on an as-needed basis: 
service network-manager restart 
 
 
Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so. 
 
 
==Pidgin==
This section is for building Pidgin and Farsight from source. 
Pidgin has XMMP videoconferencing abilities that may be helpful in a A/V production environment. 
 
apt-get install cdbs dh-autoreconf dh-translations gir1.2-farstream-0.1 hardening-wrapper mercurial-git libavahi-glib-dev libdbus-glib-1-dev libenchant-dev libgadu3 libgadu-dev libgtkspell-dev libgtkspell-3-dev libidn11-dev libjson-glib-dev liblaunchpad-integration-dev libmeanwhile-dev libncursesw5-dev libnspr4-dev libnss3-dev libperl-dev libsasl2-dev libsqlite3-dev libstartup-notification0-dev libwebkitgtk-3.0-dev libxss-dev libzephyr-dev network-manager-dev python-dev python-gtk2-dev python-scour tcl tcl-dev tcl8.5 tcl8.5-dev tk tk-dev tk8.5 tk8.5-dev x11proto-scrnsaver-dev 
 
cd /packages 
wget http://gstreamer.freedesktop.org/src/gst-python/gst-python-0.10.22.tar.gz 
tar -xvzf gst-python-0.10.22.tar.gz && cd gst-python-0.10.22 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
wget "http://nice.freedesktop.org/releases/libnice-0.1.4.tar.gz" 
tar -xvzf libnice-0.1.4.tar.gz && cd libnice-0.1.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Skip the following two blocks if building Pidgin against GStreamer 1.0] 
wget http://freedesktop.org/software/farstream/releases/farstream/farstream-0.1.2.tar.gz 
tar -xvzf farstream-0.1.2.tar && cd farstream-0.1.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
http://sourceforge.net/projects/pidgin/files/Pidgin/2.10.7/pidgin-2.10.7.tar.bz2 ==> download file 
cd /packages 
tar -xvjf pidgin-2.10.7.tar.bz2 && cd pidgin-2.10.7 
./configure --prefix=/packages/openvideopro --with-gstreamer=0.10 &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
[/skip] 
 
 
[Experimental section; builds and launches but Pidgin<->GStreamer 1.0 lockups triggered on events...] 
cd /packages 
wget "http://freedesktop.org/software/farstream/releases/farstream/farstream-0.2.3.tar.gz" 
tar -xvzf farstream-0.2.3.tar.gz && cd farstream-0.2.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
hg clone http://hg.pidgin.im/pidgin/main pidgin_1may2013 && cd pidgin_1may2013 
NOCONFIGURE=1 ./autogen.sh &>gsc_autogen.log 
GTK_LIBS='-L/packages/openvideopro/lib -lgstvideo-1.0' ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1 make install
[/end experimental section] 
 
 
 
 
==Totem==
apt-get install itstool libclutter-gst-dev libclutter-gtk-1.0-dev gsettings-desktop-schemas-dev libbonobo2-dev libgail-dev libxtst-dev libgmime-2.6-dev libsoup-gnome2.4-dev gobject-introspection libpeas-dev libvala-0.16-dev valac-0.16-vapi valac-0.16 pylint liblircclient-dev 
 
[Include support for non-libre standards implemented using free software...] 
apt-get install libbz2-dev libcurl4-gnutls-dev libfaad-dev libmms-dev libgio2.0-cil-dev 
 
cd /packages && wget "http://downloads.xiph.org/releases/opus/opus-1.0.2.tar.gz" 
tar -xvzf opus-1.0.2.tar.gz && cd opus-1.0.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-bad/gst-plugins-bad-1.0.7.tar.xz" 
tar -xvJf gst-plugins-bad-1.0.7.tar.xz && cd gst-plugins-bad-1.0.7 
OPUS_CFLAGS='-I/packages/openvideopro/include' ./configure --enable-experimental --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/clutter-gst/2.0/clutter-gst-2.0.0.tar.xz" 
tar -xvJf clutter-gst-2.0.0.tar.xz && cd clutter-gst-2.0.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/atk/2.8/atk-2.8.0.tar.xz" 
tar -xvJf atk-2.8.0.tar.xz && cd atk-2.8.0 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget http://ftp.gnome.org/pub/GNOME/sources/at-spi2-core/2.8/at-spi2-core-2.8.0.tar.xz 
tar -xvJf at-spi2-core-2.8.0.tar.xz && cd at-spi2-core-2.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/at-spi2-atk/2.8/at-spi2-atk-2.8.1.tar.xz" 
tar -xvJf at-spi2-atk-2.8.1.tar.xz && cd at-spi2-atk-2.8.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/gtk+/3.6/gtk+-3.6.4.tar.xz" 
tar -xvJf gtk+-3.6.4.tar.xz && cd gtk+-3.6.4 
./configure --prefix=/packages/openvideopro --disable-glibtest &>gsc_config.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/gobject-introspection/1.36/gobject-introspection-1.36.0.tar.xz" 
tar -xvJf gobject-introspection-1.36.0.tar.xz && cd gobject-introspection-1.36.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://cairographics.org/releases/py2cairo-1.10.0.tar.bz2" 
tar -xvjf py2cairo-1.10.0.tar.bz2 && cd py2cairo-1.10.0 
./waf configure --prefix=/packages/openvideopro &>gsc_config.log 
./waf build &>gsc_build.log 
./waf install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/pygobject/3.9/pygobject-3.9.1.tar.xz" 
tar -xvJf pygobject-3.9.1.tar.xz && cd pygobject-3.9.1 
./configure --disable-glibtest --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/totem-pl-parser/3.4/totem-pl-parser-3.4.4.tar.xz" 
tar -xvJf totem-pl-parser-3.4.4.tar.xz && cd totem-pl-parser-3.4.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.acc.umu.se/pub/GNOME/sources/grilo/0.2/grilo-0.2.5.tar.xz" 
tar -xvJf grilo-0.2.5.tar.xz && cd grilo-0.2.5 
./configure --disable-debug --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/GNOME/sources/totem/3.8/totem-3.8.0.tar.xz" 
tar -xvJf totem-3.8.0.tar.xz && cd totem-3.8.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log

GST cookbook/Trisquel6

2013-05-02T18:39:33Z

GChriss: add Pidgin build notes

Trisquel Release 6.0 (toutatis) GStreamer Build Instructions 
Tested on a Lenovo x201i by GChriss / 15-April-2013 
 
Prepare live USB key as documented: 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
Boot USB key in BIOS -> Install to disk -> Manual partition 
Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions 
 
Run through install prompts and reboot 
Works out-of-box: backlight, suspend, audio, USB, 10/100 Ethernet, graphics acceleration, Atheros AR5418 Wireless Network Adapter (168c:0024 -- BIOS modification required) 
 
Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations 
 
Open Terminal: 
sudo su 
 
Get this stuff outta here... 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 pidgin-data gstreamer0.10-tools gnome-app-install 
 
apt-get update 
 
 echo "linux-image-generic hold" | dpkg --set-selections 
(To undo: echo "linux-image-generic install" | dpkg --set-selections ) 
apt-get dist-upgrade 
 
apt-get install bzip2 wget curl bison flex fakeroot vim mlocate subversion git-core openssh-server build-essential libtool intltool checkinstall autoconf automake kernel-package libasound2-dev libcanberra-gtk3-dev libffi-dev libfftw3-dev libgconf2-dev libglade2-dev libglib2.0-dev libglib2.0-dev libgnome-media-profiles-dev libgtk2.0-dev libgtkmm-3.0-dev libjson0-dev libncurses5-dev libqt3-mt-dev libsamplerate0-dev libsdl1.2-dev libsndfile1-dev libspeexdsp-dev libudev-dev libv4l-dev libxi-dev libxml2-dev libxmu-dev libxv-dev pciutils-dev cu sysfsutils gtk-doc-tools gnome-doc-utils iasl alsa-tools lm-sensors mkvtoolnix mkvtoolnix-gui cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
Create this file and add the line that follows: 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local --> add the following: 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
Optional but helpful step for realtime audio processing 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y' 
Consider adding Easycap: CONFIG_MEDIA_ANALOG_TV_SUPPORT=y + CONFIG_VIDEO_STK1160=m 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
reboot and check for PREEMPT in 'uname -a': 
Linux x201 3.8.6-gnu #1 SMP PREEMPT Sat Apr 13 02:07:48 EDT 2013 x86_64 x86_64 x86_64 GNU/Linux 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc -> add the following: 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
YASM is optional: 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
vi /etc/security/limits.conf -> add the following line: 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf -> create file with the following line: 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss --> subsitute 'gchriss' for your username 
exit 
 
At this point UI volume controls are missing/non-functional, but alsamixer works. 
Build pulseaudio if needed, but otherwise optional: 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
Also optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012 
--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c' 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons) 
TODO: The following builds but fails to connect to pulseaudio... debug needed? 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Rebuild Totem + PiTiVi 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
Open abrowser, download: 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/glib/2.34/glib-2.34.3.tar.xz" 
tar -xvJf glib-2.34.3.tar.xz && cd glib-2.34.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
'make check' failures are "OK" 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional but really helpful: 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
=== 
Create the following block entries for automatic execution @ user login 
The first two entries are specific to managing Thinkpad-series laptops 
 
 
gsc@host:~$ cat ~/.config/autostart/cpufreq-selector.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=cpu-freq-selector 
Name=cpufreq-selector 
Comment[en_US]=Set 2.4GHz (x4) 
Comment=Set 2.4GHz (x4) 
 
 
gsc@host:~$ cat ~/.config/autostart/echo.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=Spin up x201i Fan 
Name=Spin up x201i Fan 
Comment[en_US]=Substitute 'disengaged' for '7' for max speed 
Comment=Substitute 'disengaged' for '7' for max speed 
 
 
gsc@host:~$ cat ~/.config/autostart/gnome-terminal.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=gnome-terminal 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=GNOME Terminal 
Name=GNOME Terminal 
Comment[en_US]=Just to get things started... 
Comment=Just to get things started... 
 
 
gsc@host:~$ cat ~/.config/autostart/qjackctl.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=qjackctl 
Name=qjackctl 
Comment[en_US]=Launch openvideopro qjackctl / -GChriss 
Comment=Launch openvideopro qjackctl / -GChriss 
 
=== 
 
 
sudo updatedb 
 
Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX 
 
 
network-manager can sometimes be flaky, issue on an as-needed basis: 
service network-manager restart 
 
 
Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so. 
 
 
==Pidgin==
This section is for building Pidgin and Farsight from source. 
Pidgin has XMMP videoconferencing abilities that may be helpful in a A/V production environment. 
 
apt-get install cdbs dh-autoreconf dh-translations gir1.2-farstream-0.1 hardening-wrapper mercurial-git libavahi-glib-dev libdbus-glib-1-dev libenchant-dev libgadu3 libgadu-dev libgtkspell-dev libgtkspell-3-dev libidn11-dev libjson-glib-dev liblaunchpad-integration-dev libmeanwhile-dev libncursesw5-dev libnspr4-dev libnss3-dev libperl-dev libsasl2-dev libsqlite3-dev libstartup-notification0-dev libwebkitgtk-3.0-dev libxss-dev libzephyr-dev network-manager-dev python-dev python-gtk2-dev python-scour tcl tcl-dev tcl8.5 tcl8.5-dev tk tk-dev tk8.5 tk8.5-dev x11proto-scrnsaver-dev 
 
cd /packages 
wget http://gstreamer.freedesktop.org/src/gst-python/gst-python-0.10.22.tar.gz 
tar -xvzf gst-python-0.10.22.tar.gz && cd gst-python-0.10.22 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
wget "http://nice.freedesktop.org/releases/libnice-0.1.4.tar.gz" 
tar -xvzf libnice-0.1.4.tar.gz && cd libnice-0.1.4 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Skip the following two blocks if building Pidgin against GStreamer 1.0] 
wget http://freedesktop.org/software/farstream/releases/farstream/farstream-0.1.2.tar.gz 
tar -xvzf farstream-0.1.2.tar && cd farstream-0.1.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
http://sourceforge.net/projects/pidgin/files/Pidgin/2.10.7/pidgin-2.10.7.tar.bz2 ==> download file 
cd /packages 
tar -xvjf pidgin-2.10.7.tar.bz2 && cd pidgin-2.10.7 
./configure --prefix=/packages/openvideopro --with-gstreamer=0.10 &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
[/skip] 
 
 
[Experimental section; builds and launches but Pidgin<->GStreamer 1.0 lockups triggered on events...] 
cd /packages 
wget "http://freedesktop.org/software/farstream/releases/farstream/farstream-0.2.3.tar.gz" 
tar -xvzf farstream-0.2.3.tar.gz && cd farstream-0.2.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
hg clone http://hg.pidgin.im/pidgin/main pidgin_1may2013 && cd pidgin_1may2013 
NOCONFIGURE=1 ./autogen.sh &>gsc_autogen.log 
GTK_LIBS='-L/packages/openvideopro/lib -lgstvideo-1.0' ./configure --prefix=/packages/openvideopro &>gsc_config.log 
[TODO: Fix 'GtkSpell support' issues] 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
[/end experimental section]

GST cookbook/Trisquel6

2013-05-01T21:32:16Z

GChriss: re-order apt-get install list for ease-of-reading

GST cookbook/Trisquel6

2013-05-01T21:03:38Z

GChriss: +checkinstall to apt-get install list: needed for pidgin

GST cookbook/Trisquel6

2013-05-01T21:01:38Z

GChriss: addition of to-be-rebuilt gstreamer plugins to apt-get remove list

GST cookbook/Trisquel6

2013-05-01T20:39:44Z

GChriss: hold back automatic kernel updates

GST cookbook/Trisquel6

2013-04-16T15:23:50Z

GChriss: add Easycap kernel .config options

GST cookbook/Trisquel6

2013-04-15T15:39:47Z

GChriss: this is a Lenovo x201i

GST cookbook

2013-04-15T15:09:06Z

GChriss: /* Live-stream an Elphel 353L camera... */ add gst-launch-1.0 version

GStreamer is a powerful multimedia infrastructure for applications—providing a number of programming language constructs and bindings—but also provides easy-to-use rapid prototyping tools to test new multimedia pipelines. Additionally, Gstreamer usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point. This page is a collection of gst-launch pipelines that can be used on an as-needed basis.

__TOC__

<center>
<div style="background-color: #ffffff; border: 1px solid #000000; color: black; font-weight: bold; margin: 2em 0 1em; padding: .5em 1em; vertical-align: middle;">Note that some examples are "high-performance" pipelines which require purpose-built systems. [[GST_cookbook/gNewSense|gNewSense build notes]] | [[GST_cookbook/Trisquel6|Trisquel Build Notes]]</div> </center>

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Dual Ogg Theora + Ogg Vorbis Streams -> Icecast ===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src device=/dev/video0 ! queue max-size-bytes=100000000 max-size-time=0 ! deinterlace mode=interlaced ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=360,height=240,pixel-aspect-ratio=1/1 ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! audioamplify amplification=[1-6 or so] ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=server.com port=[80|8000] password=hackme mount=/mountpoint.ogv vorbisaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=server.com port=[80|8000] password=hackme mount=/mountpoint.oga

:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live audio+video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU leading to dropped frames.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority
 
*gst-launch-'''0.10''' -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! alsasink
 
*gst-launch-'''1.0''' -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 client-name="GStreamer Input" ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw,width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=500 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoconvert ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! alsasink
 
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity. The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===<div id=ElphelJP46>Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen</div>===
*[https://media.xiph.org/jp46_cookbook/ Video samples]
*Setup a high-performance system: tested on Gigabyte GA-MA785GMT-UD2H + (non-overclocked) Phenom II X4 [[GST_cookbook/gNewSense|built using gNewSense.]] CPU utilization approaches 100%, continuously, across all four 3.2GHz cores.
*Set the camera to 1920x1088, JPEG Image Quality @ 90%, JP46 color mode
In separate tabs:
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

===Dump high-resolution image stills from Matroska containers into a folder===
*gst-launch filesrc location=recording.mkv ! queue ! matroskademux ! queue ! videorate ! image/jpeg,framerate=1/10 ! queue ! multifilesink location="image%04d.jpg" sync=false

*Remove any colons input filenames to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook

2013-04-15T14:59:31Z

GChriss: rebuild intro + include build instruction box

GStreamer is a powerful multimedia infrastructure for applications—providing a number of programming language constructs and bindings—but also provides easy-to-use rapid prototyping tools to test new multimedia pipelines. Additionally, Gstreamer usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point. This page is a collection of gst-launch pipelines that can be used on an as-needed basis.

__TOC__

<center>
<div style="background-color: #ffffff; border: 1px solid #000000; color: black; font-weight: bold; margin: 2em 0 1em; padding: .5em 1em; vertical-align: middle;">Note that some examples are "high-performance" pipelines which require purpose-built systems. [[GST_cookbook/gNewSense|gNewSense build notes]] | [[GST_cookbook/Trisquel6|Trisquel Build Notes]]</div> </center>

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Dual Ogg Theora + Ogg Vorbis Streams -> Icecast ===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src device=/dev/video0 ! queue max-size-bytes=100000000 max-size-time=0 ! deinterlace mode=interlaced ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=360,height=240,pixel-aspect-ratio=1/1 ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! audioamplify amplification=[1-6 or so] ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=server.com port=[80|8000] password=hackme mount=/mountpoint.ogv vorbisaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=server.com port=[80|8000] password=hackme mount=/mountpoint.oga

:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===<div id=ElphelJP46>Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen</div>===
*[https://media.xiph.org/jp46_cookbook/ Video samples]
*Setup a high-performance system: tested on Gigabyte GA-MA785GMT-UD2H + (non-overclocked) Phenom II X4 [[GST_cookbook/gNewSense|built using gNewSense.]] CPU utilization approaches 100%, continuously, across all four 3.2GHz cores.
*Set the camera to 1920x1088, JPEG Image Quality @ 90%, JP46 color mode
In separate tabs:
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

===Dump high-resolution image stills from Matroska containers into a folder===
*gst-launch filesrc location=recording.mkv ! queue ! matroskademux ! queue ! videorate ! image/jpeg,framerate=1/10 ! queue ! multifilesink location="image%04d.jpg" sync=false

*Remove any colons input filenames to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook/Trisquel6

2013-04-15T14:37:09Z

GChriss: add Trisquel build notes

Trisquel Release 6.0 (toutatis) GStreamer Build Instructions 
Tested on 15-April-2013 by GChriss 
 
Prepare live USB key as documented: 
wget "http://cdimage.trisquel.info/trisquel-images/trisquel_6.0_amd64.iso.torrent" 
transmission-gtk trisquel_6.0_amd64.iso.torrent & 
dd if=/path/to/trisquel_6.0_amd64.iso of=/dev/sdX bs=8M 
sync 
cd /media/trisquel\ 6.0\ amd64/ 
md5sum -c md5sum.txt 
 
Boot USB key in BIOS -> Install to disk -> Manual partition 
Use a smaller '/' partition (~20GB), ~2GB swap space, the remainder as '/home', all primary partitions 
 
Run through install prompts and reboot 
 
Trisquel Menu -> System Settings -> Disable screensaver, screen dimming, suspend-on-lid-close, sound effects, window animations 
 
Open Terminal: 
sudo su 
 
Get this stuff outta here... 
/etc/init.d/apparmor stop 
update-rc.d -f apparmor remove 
apt-get --purge remove apparmor apparmor-utils libapparmor-perl libapparmor1 gnash libjack-jackd2-0 
 
apt-get update 
 
apt-get dist-upgrade 
 
apt-get install fakeroot kernel-package libncurses5-dev libqt3-mt-dev bzip2 wget build-essential autoconf libtool libglib2.0-dev bison flex libxml2-dev alsa-tools libasound2-dev vim mlocate libxv-dev libxmu-dev libxi-dev libsamplerate0-dev libsndfile1-dev git-core curl lm-sensors openssh-server iasl automake libsdl1.2-dev libgtk2.0-dev libglib2.0-dev libglade2-dev libffi-dev pciutils-dev cu sysfsutils mkvtoolnix mkvtoolnix-gui subversion cpuburn indicator-multiload indicator-cpufreq qt4-dev-tools intltool libjson0-dev libudev-dev libfftw3-dev libspeexdsp-dev gnome-doc-utils libgconf2-dev libv4l-dev libgnome-media-profiles-dev libgtkmm-3.0-dev libcanberra-gtk3-dev 
 
chmod 0755 /usr/bin/cpufreq-selector 
 
Create this file and add the line that follows: 
vi /etc/modprobe.d/thinkpad_acpi.conf 
options thinkpad_acpi fan_control=1 
 
vi /etc/rc.local --> add the following: 
chmod 666 /proc/acpi/ibm/fan 
 
exit 
 
indicator-multiload & 
 
 
Optional but helpful step for realtime audio processing 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.6-gnu.tar.bz2" 
tar -xvjf linux-libre-3.8.6-gnu.tar.bz2 
cd linux-3.8.6/ 
cp /boot/config-3.2.0-38-generic .config 
make oldconfig -> hold down enter key to accept defaults 
make gconfig 
'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y' 
CONCURRENCY_LEVEL=4 fakeroot make deb-pkg &>gsc_make-deb-pkg.log 
dpkg -i ../*.deb 
 
 
reboot and check for PREEMPT in 'uname -a': 
Linux x201 3.8.6-gnu #1 SMP PREEMPT Sat Apr 13 02:07:48 EDT 2013 x86_64 x86_64 x86_64 GNU/Linux 
 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc -> add the following: 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_14april2013 && cd nasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
YASM is optional: 
cd /packages 
git clone git://github.com/yasm/yasm.git yasm_14april2013 && cd yasm_14april2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
git clone git://code.entropywave.com/git/orc.git orc_14april2013 && cd orc_14april2013 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
sudo su 
vi /etc/security/limits.conf -> add the following line: 
@audio - rtprio 99 
 
vi /etc/security/limits.d/audio.conf -> create file with the following line: 
@audio - rtprio 95 
@audio - memlock unlimited 
 
usermod -a -G audio gchriss --> subsitute 'gchriss' for your username 
exit 
 
At this point UI volume controls are missing/non-functional, but alsamixer works. 
Build pulseaudio if needed, but otherwise optional: 
rm -rf ~/.pulse* /tmp/.esd* 
sudo -rf /tmp/pulse* 
cd /packages && wget "http://freedesktop.org/software/pulseaudio/releases/pulseaudio-3.0.tar.xz" 
tar -xvJf pulseaudio-3.0.tar.xz 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
sudo make install &>gsc_install.log 
mkdir -p /packages/openvideopro/var/run/pulse && mkdir -p /packages/openvideopro/var/lib/pulse 
 
Also optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
See: http://cgit.freedesktop.org/gstreamer/gst-plugins-good/commit/?id=9f2aa8d47f835ea155aaf635f618c0fc1ca87012 
--> Remove line containing 'vbuffer.input' in 'sys/v4l2/gstv4l2bufferpool.c' 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional: 
cd /packages && wget https://launchpad.net/gnome-media/main/2.91.2/+download/gnome-media-2.91.2.tar.bz2 
tar -xvjf gnome-media-2.91.2.tar.bz2 && cd gnome-media-2.91.2 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Figure out how to rebuild UI volume controls (e.g., keyboard volume buttons) 
TODO: The following builds but fails to connect to pulseaudio... debug needed? 
git clone git://git.0pointer.de/pavucontrol pavucontrol_15april2013 && cd pavucontrol_15april2013 
./bootstrap.sh &>gsc_bootstrap.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
 
TODO: Rebuild Totem + PiTiVi 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar.bz2 && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
Open abrowser, download: 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro --with-jpeg8 &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 && cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" 
tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://ftp.gnome.org/pub/gnome/sources/glib/2.34/glib-2.34.3.tar.xz" 
tar -xvJf glib-2.34.3.tar.xz && cd glib-2.34.3 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
'make check' failures are "OK" 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.27.tar.bz2" 
tar -xvjf alsa-lib-1.0.27.tar.bz2 && cd alsa-lib-1.0.27 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-1.0.6.tar.xz" 
tar -xvJf gstreamer-1.0.6.tar.xz && cd gstreamer-1.0.6 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-1.0.6.tar.xz" 
tar -xvJf gst-plugins-base-1.0.6.tar.xz && cd gst-plugins-base-1.0.6 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make check &>gsc_check.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-1.0.6.tar.xz" 
tar -xvJf gst-plugins-good-1.0.6.tar.xz && cd gst-plugins-good-1.0.6 
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/packages/openvideopro/lib64/pkgconfig ./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
Optional but really helpful: 
cd /packages && wget "http://downloads.sourceforge.net/qjackctl/qjackctl-0.3.10.tar.gz" 
tar -xvzf qjackctl-0.3.10.tar.gz && cd qjackctl-0.3.10 
./configure --prefix=/packages/openvideopro --with-jack=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
 
 
=== 
Create the following block entries for automatic execution @ user login 
The first two entries are specific to managing Thinkpad-series laptops 
 
 
gsc@host:~$ cat ~/.config/autostart/cpufreq-selector.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "/usr/bin/cpufreq-selector -c 0 -g performance & /usr/bin/cpufreq-selector -c 1 -g performance & /usr/bin/cpufreq-selector -c 2 -g performance & /usr/bin/cpufreq-selector -c 3 -g performance" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=cpu-freq-selector 
Name=cpufreq-selector 
Comment[en_US]=Set 2.4GHz (x4) 
Comment=Set 2.4GHz (x4) 
 
 
gsc@host:~$ cat ~/.config/autostart/echo.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "echo level 7 > /proc/acpi/ibm/fan" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=Spin up x201i Fan 
Name=Spin up x201i Fan 
Comment[en_US]=Substitute 'disengaged' for '7' for max speed 
Comment=Substitute 'disengaged' for '7' for max speed 
 
 
gsc@host:~$ cat ~/.config/autostart/gnome-terminal.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=gnome-terminal 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=GNOME Terminal 
Name=GNOME Terminal 
Comment[en_US]=Just to get things started... 
Comment=Just to get things started... 
 
 
gsc@host:~$ cat ~/.config/autostart/qjackctl.desktop 
 
[Desktop Entry] 
Type=Application 
Exec=sh -c "PATH=/packages/openvideopro/bin:$PATH LD_LIBRARY_PATH=/packages/openvideopro/lib64 /packages/openvideopro/bin/qjackctl" 
Hidden=false 
NoDisplay=false 
X-GNOME-Autostart-enabled=true 
Name[en_US]=qjackctl 
Name=qjackctl 
Comment[en_US]=Launch openvideopro qjackctl / -GChriss 
Comment=Launch openvideopro qjackctl / -GChriss 
 
=== 
 
 
sudo updatedb 
 
Stress-test CPU temperature stability (often necessary, proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX 
 
 
network-manager can sometimes be flaky, issue on an as-needed basis: 
service network-manager restart 
 
 
Start JACK either via command-line or 'Start' button in QjackCtl, launch GStreamer pipeline, then renice pipeline to -18 or so.

GST cookbook

2013-03-24T13:50:12Z

GChriss: /* A v4l2 source + ALSA source -> Ogg Theora -> IceCast */ substitute a better pipeline for the same task

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Dual Ogg Theora + Ogg Vorbis Streams -> Icecast ===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src device=/dev/video0 ! queue max-size-bytes=100000000 max-size-time=0 ! deinterlace mode=interlaced ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=360,height=240,pixel-aspect-ratio=1/1 ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! audioamplify amplification=[1-6 or so] ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=server.com port=[80|8000] password=hackme mount=/mountpoint.ogv vorbisaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=server.com port=[80|8000] password=hackme mount=/mountpoint.oga

:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===<div id=ElphelJP46>Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen</div>===
*[https://media.xiph.org/jp46_cookbook/ Video samples]
*Setup a high-performance system: tested on Gigabyte GA-MA785GMT-UD2H + (non-overclocked) Phenom II X4 [[GST_cookbook/gNewSense|built using gNewSense.]] CPU utilization approaches 100%, continuously, across all four 3.2GHz cores.
*Set the camera to 1920x1088, JPEG Image Quality @ 90%, JP46 color mode
In separate tabs:
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

===Dump high-resolution image stills from Matroska containers into a folder===
*gst-launch filesrc location=recording.mkv ! queue ! matroskademux ! queue ! videorate ! image/jpeg,framerate=1/10 ! queue ! multifilesink location="image%04d.jpg" sync=false

*Remove any colons input filenames to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook

2013-03-18T22:03:12Z

GChriss: /* Live-stream an Elphel 353L camera set at 'FullHD' JP46*/ + link to video samples

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===<div id=ElphelJP46>Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen</div>===
*[https://media.xiph.org/jp46_cookbook/ Video samples]
*Setup a high-performance system: tested on Gigabyte GA-MA785GMT-UD2H + (non-overclocked) Phenom II X4 [[GST_cookbook/gNewSense|built using gNewSense.]] CPU utilization approaches 100%, continuously, across all four 3.2GHz cores.
*Set the camera to 1920x1088, JPEG Image Quality @ 90%, JP46 color mode
In separate tabs:
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

===Dump high-resolution image stills from Matroska containers into a folder===
*gst-launch filesrc location=recording.mkv ! queue ! matroskademux ! queue ! videorate ! image/jpeg,framerate=1/10 ! queue ! multifilesink location="image%04d.jpg" sync=false

*Remove any colons input filenames to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook

2013-03-18T15:48:06Z

GChriss: /* Live-stream an Elphel 353L camera set at 'FullHD' JP46 // */ try adding a named anchor for external linking

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===<div id=ElphelJP46>Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen</div>===

*Setup a high-performance system: tested on Gigabyte GA-MA785GMT-UD2H + (non-overclocked) Phenom II X4 [[GST_cookbook/gNewSense|built using gNewSense.]] CPU utilization approaches 100%, continuously, across all four 3.2GHz cores.
*Set the camera to 1920x1088, JPEG Image Quality @ 90%, JP46 color mode
In separate tabs:
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

===Dump high-resolution image stills from Matroska containers into a folder===
*gst-launch filesrc location=recording.mkv ! queue ! matroskademux ! queue ! videorate ! image/jpeg,framerate=1/10 ! queue ! multifilesink location="image%04d.jpg" sync=false

*Remove any colons input filenames to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook

2013-03-18T15:42:37Z

GChriss: move JP4 pipeline + add notes + expand Matroska image dump pipeline

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen===
*Setup a high-performance system: tested on Gigabyte GA-MA785GMT-UD2H + (non-overclocked) Phenom II X4 [[GST_cookbook/gNewSense|built using gNewSense.]] CPU utilization approaches 100%, continuously, across all four 3.2GHz cores.
*Set the camera to 1920x1088, JPEG Image Quality @ 90%, JP46 color mode
In separate tabs:
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

===Dump high-resolution image stills from Matroska containers into a folder===
*gst-launch filesrc location=recording.mkv ! queue ! matroskademux ! queue ! videorate ! image/jpeg,framerate=1/10 ! queue ! multifilesink location="image%04d.jpg" sync=false

*Remove any colons input filenames to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook/gNewSense

2013-03-18T15:24:05Z

GChriss: add gNewSense build instructions. traces of nuts, but a good set overall

gNewSense GStreamer 0.10 Build Instructions 
Tested on 18-March-2013 by GChriss 
 
Prepare live USB key as documented, double-check boot flag 
 
Boot USB key in BIOS -> Install to disk -> Manual partition 
Use a smaller '/' partition (~20GB), ~20GB swap space, the remainder as '/home' 
 
reboot 
 
apt-get update 
 
apt-get dist-upgrade 
 
apt-get install fakeroot kernel-package libncurses5-dev libqt3-mt-dev bzip2 wget build-essential autoconf libtool libglib2.0-dev bison flex libxml2-dev alsa-tools libasound2-dev vim mlocate libxmu-dev libxi-dev libsamplerate0-dev libsndfile1-dev git-core curl lm-sensors sensors-applet openssh-server flex bison iasl automake libsdl1.2-dev libgtk2.0-dev libglib2.0-dev libglade2-dev libffi4-dev pciutils-dev cu sysfsutils mkvtoolnix mkvtoolnix-gui subversion cpuburn 
 
[For realtime GNUSense kernel, optional but helpful for audio quality] 
http://www.gnewsense.org/Documentation/BuildKernel 
+apply patch: http://twobit.us/blog/2010/06/debian-lenny-make-kpkg-broken-with-new-kernel/ 
sudo su 
cd /usr/src 
wget "http://linux-libre.fsfla.org/pub/linux-libre/releases/LATEST-3.8.N/linux-libre-3.8.1-gnu.tar.bz2" 
tar xvjf linux-libre-3.8.1-gnu.tar.bz2 
cd linux-3.8.1/ 
cp /boot/config-2.6.24-32-generic ./.config 
make oldconfig 
make gconfig 
[See attached .config. 'CONFIG_PREEMPT=y' + ALSA built as modules, 'CONFIG_HZ_100=y'] 
CONCURRENCY_LEVEL=4 fakeroot make-kpkg --initrd kernel_image kernel_headers 
[See http://www.debian-administration.org/articles/90 ] 
cd /usr/src/ 
dpkg -i linux-headers-3.8.1-gnu_3.8.1-gnu-10.00.Custom_i386.deb linux-image-3.8.1-gnu_3.8.1-gnu-10.00.Custom_i386.deb 
chmod 4755 /usr/bin/cpufreq-selector 
reboot 
Test GNOME CPU freq applet 
 
gsc@host:~$ uname -a 
Linux host 3.8.1-gnu #1 SMP PREEMPT Sun Mar 3 16:40:14 EST 2013 i686 GNU/Linux 
 
sudo su 
mkdir -p /packages/openvideopro && mkdir -p /packages/openvideopro/lib && mkdir -p /packages/openvideopro/bin 
mkdir -p /packages/openvideopro/lib/pkgconfig 
chown -R gchriss:users /packages/openvideopro 
exit 
rm -Rf ~/.gstreamer-0.10 
vi ~/.bashrc, add the following: 
export GST_PLUGIN_SYSTEM_PATH="/packages/openvideopro/lib" 
export GST_PLUGIN_PATH="/packages/openvideopro/lib" 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig 
export PATH=/packages/openvideopro/bin:$PATH 
 
 
cd /packages 
git clone git://repo.or.cz/nasm.git nasm_3march2013 
cd nasm_3march2013 
./autogen.sh --no-configure &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
[Optional] 
cd /packages 
git clone git://github.com/yasm/yasm.git && cd yasm 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
git clone git://code.entropywave.com/git/orc.git && cd orc 
./autogen.sh &>gsc_autogen.log 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/ogg/libogg-1.3.0.tar.gz" 
tar -xvzf libogg-1.3.0.tar.gz && cd libogg-1.3.0 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.3.tar.gz" 
tar -xvzf libvorbis-1.3.3.tar.gz && cd libvorbis-1.3.3/ 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
export PKG_CONFIG_PATH=/packages/openvideopro/lib/pkgconfig 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
cd /packages && wget "http://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2" 
tar -xvjf libtheora-1.1.1.tar && cd libtheora-1.1.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
Open browser, download: 
http://sourceforge.net/projects/libjpeg-turbo/files/1.2.90%20%281.3beta1%29/libjpeg-turbo-1.2.90.tar.gz/download 
cd /packages && tar -xvzf libjpeg-turbo-1.2.90.tar.gz && cd libjpeg-turbo-1.2.90 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://dl.matroska.org/downloads/libebml/libebml-1.2.2.tar.bz2" 
tar -xvjf libebml-1.2.2.tar.bz2 & cd libebml-1.2.2 
make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://dl.matroska.org/downloads/libmatroska/libmatroska-1.3.0.tar.bz2" 
tar -xvjf libmatroska-1.3.0.tar.bz2 && cd libmatroska-1.3.0/ 
CXXFLAGS='-I/packages/openvideopro/include' make -C make/linux install_staticlib install_headers prefix=/packages/openvideopro &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://downloads.xiph.org/releases/libshout/libshout-2.3.1.tar.gz" && tar -xvzf libshout-2.3.1.tar.gz && cd libshout-2.3.1 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://ftp.acc.umu.se/pub/gnome/sources/glib/2.28/glib-2.28.8.tar.bz2" 
tar -xvjf glib-2.28.8.tar.bz2 && cd glib-2.28.8 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
['make check' failures are "OK"] 
make install &>gsc_install.log 
 
cd /packages && wget "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-1.0.26.tar.bz2" 
tar -xvjf alsa-lib-1.0.26.tar.bz2 && cd alsa-lib-1.0.26 
./configure --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://gstreamer.freedesktop.org/src/gstreamer/gstreamer-0.10.36.tar.gz" 
tar -xvzf gstreamer-0.10.36.tar.gz && cd gstreamer-0.10.36 
./configure --enable-failing-tests --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
wget "http://gstreamer.freedesktop.org/src/gst-plugins-base/gst-plugins-base-0.10.36.tar.gz" 
tar -xvzf gst-plugins-base-0.10.36.tar.gz && cd gst-plugins-base-0.10.36 
export CFLAGS='-msse -mmmx -msse2' && export CXXFLAGS='-msse -mmmx -msse2' 
./configure --enable-orc --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_config.log 
make install &>gsc_install.log 
 
wget "http://gstreamer.freedesktop.org/src/gst-plugins-good/gst-plugins-good-0.10.31.tar.gz" 
export CFLAGS='-msse -mmmx -msse2' && export CXXFLAGS='-msse -mmmx -msse2' 
tar -xvzf gst-plugins-good-0.10.31.tar.gz && cd gst-plugins-good-0.10.31 
./configure --enable-experimental --enable-orc --prefix=/packages/openvideopro &>gsc_configure.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
cd /packages 
svn checkout http://gst-plugins-elphel.googlecode.com/svn/trunk/ gst-plugins-elphel 
cd gst-plugins-elphel/jp462bayer 
./autogen &>gsc_autogen.log 
./configure --enable-debug --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
cd ../bayer2rgb2/ 
 
cd /packages 
wget "http://jackaudio.org/downloads/jack-audio-connection-kit-0.121.3.tar.gz" 
tar -xvzf jack-audio-connection-kit-0.121.3.tar.gz && cd jack-audio-connection-kit-0.121.3 
vi tools/alsa_in.c, change: 
delay = snd_pcm_avail( alsa_handle ); ==to== 
delay = snd_pcm_avail_update( alsa_handle ); 
vi tools/alsa_out.c, change: 
delay = (num_periods*period_size)-snd_pcm_avail( alsa_handle ) ; ==to== 
delay = (num_periods*period_size)-snd_pcm_avail_update( alsa_handle ) ; 
[Breaks alsa_in, alsa_out playback/recording but enables compilation...] 
./configure --enable-optimize --prefix=/packages/openvideopro &>gsc_config.log 
make V=1 &>gsc_make.log 
make install &>gsc_install.log 
 
updatedb 
 
Close any extra windows, file caching services, ''etc.'' 
 
Set CPU cores to >= 3.2GHz 
 
Stress-test CPU temperature stability (necessary, but proceed at own risk): 
burnMMX & burnMMX & burnMMX & burnMMX 
 
Disable screensaver, start JACK, launch GStreamer pipeline, renice pipeline to -18, set color controls via Elphel web interface (adjust brightness to achieve 18FPS, most other controls work). 
 
 
To use Totem from the command line: 
unset GST_PLUGIN_SYSTEM_PATH && unset GST_PLUGIN_PATH 
totem 
rm -Rf ~/.gstreamer-0.10 
exit

GST cookbook

2013-03-18T12:45:20Z

GChriss: /* Elphel JP4 FullHD pipeline */ new section (w/o notes)

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===Dump Stills From the Resulting High-Res Elphel Recording Into a Folder===
*gst-launch filesrc location=recording.mkv ! matroskademux ! videorate ! image/jpeg,framerate=1/10 ! multifilesink location="OUTPUT%04d.jpg"

*Remove any colons from the input filename to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills
*No queue elements are necessary
*Results in a lot of disk I/O; solid state drives would be helpful here

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

===Live-stream an Elphel 353L camera set at 'FullHD' JP46, combine with realtime audio, save a high-res copy to disk, and monitor live audio+video on-screen===
*jackd -R -d alsa -C -d hw:2 -r 48000 -i 1
*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.1.50:554 protocols=0x00000001 latency=100 ! rtpjpegdepay ! queue max-size-bytes=1000000000 max-size-time=0 ! videorate force-fps=18 ! queue max-size-bytes=1000000000 max-size-time=0 ! jpegdec max-errors=-1 idct-method=2 ! queue max-size-bytes=1000000000 max-size-time=0 ! jp462bayer threads=4 ! "video/x-raw-bayer, width=(int)1920, height=(int)1088, format=(string)grbg" ! queue max-size-bytes=1000000000 max-size-time=0 ! bayer2rgb2 method=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! "video/x-raw-yuv, format=(fourcc)I420" ! queue max-size-bytes=1000000000 max-size-time=0 ! videobalance saturation=1.9 ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=fullHD ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc idct-method=2 ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-time=0 ! audio/x-raw-float,channels=1 ! queue max-size-time=0 ! tee name=jackaudio ! queue max-size-time=0 ! vorbisenc max-bitrate=80000 ! queue max-size-time=0 ! tee name=vorbisaudio ! queue max-size-time=0 ! mux. mux. ! queue max-size-bytes=1000000000 max-size-time=0 ! filesink location=elphel_recording_`date +%s`.mkv sync=false fullHD. ! queue max-size-bytes=1000000000 max-size-time=0 ! videoscale ! "video/x-raw-yuv, width=640, height=363, aspect-ratio=(fraction)1/1" ! queue max-size-bytes=1000000000 max-size-time=0 ! tee name=downsample ! queue max-size-bytes=1000000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=1000000000 max-size-time=0 ! ximagesink pixel-aspect-ratio=1/1 sync=false downsample. ! queue max-size-bytes=100000000 max-size-time=0 ! queue max-size-bytes=1000000000 max-size-time=0 ! theoraenc bitrate=550 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream vorbisaudio. ! queue max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv jackaudio. ! queue max-size-time=0 ! audioconvert ! queue max-size-time=0 ! alsasink

GST cookbook

2012-08-09T02:36:14Z

GChriss: add prototype of multi-source video mixing

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===Dump Stills From the Resulting High-Res Elphel Recording Into a Folder===
*gst-launch filesrc location=recording.mkv ! matroskademux ! videorate ! image/jpeg,framerate=1/10 ! multifilesink location="OUTPUT%04d.jpg"

*Remove any colons from the input filename to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills
*No queue elements are necessary
*Results in a lot of disk I/O; solid state drives would be helpful here

===Mix Three Video Sources Side-by-Side-by-Side===
*gst-launch --eos-on-shutdown videotestsrc pattern=6 is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! clockoverlay halignment=1 valignment=1 shaded-background=true font-desc="Sans Bold 80" ypad=80 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! ximagesink sync=false videotestsrc is-live=true ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv,width=320,height=240 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=blue left=-640 ! queue max-size-bytes=100000000 max-size-time=0 ! mix. videotestsrc pattern=11 ! "video/x-raw-yuv, width=352, height=240" ! queue max-size-bytes=100000000 max-size-time=0 ! mix.

GST cookbook

2012-05-21T18:52:00Z

GChriss: /* Live-stream an Elphel 353L camera... */ include Firefogg + ffmpeg conversion instructions for the .mkv recording

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter] or [http://firefogg.org/ Firefogg].
:Alternatively: ffmpeg -i elphel_recording.mkv -acodec libfaac -ab 128k -pass 1 -vcodec libx264 -vpre slow -vpre main -b 8000k -threads 8 -f mp4 -y elphel_recording.mp4

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===Dump Stills From the Resulting High-Res Elphel Recording Into a Folder===
*gst-launch filesrc location=recording.mkv ! matroskademux ! videorate ! image/jpeg,framerate=1/10 ! multifilesink location="OUTPUT%04d.jpg"

*Remove any colons from the input filename to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills
*No queue elements are necessary
*Results in a lot of disk I/O; solid state drives would be helpful here

GST cookbook

2012-05-21T18:48:47Z

GChriss: /*add H.264 subsection */ new section

In addition to being a powerful multimedia infrastructure for applications Gstreamer is also a useful tool for general manipulations of multimedia data. By invoking gst-launch from the command-line with a custom pipeline many useful processing steps are possible.

Gstreamer also usually has good support for Xiph-related formats.

Unfortunately, it can be rather difficult to figure out an appropriate pipeline without a starting point.

Here are some useful examples: 

===Encode a .wav to Vorbis:===
*gst-launch filesrc location="INPUT.wav" ! wavparse ! audioconvert ! vorbisenc ! oggmux ! filesink location="OUTPUT.ogg"

===Dump a Theora video to PNGs:===
*gst-launch filesrc location="INPUT.ogv" ! oggdemux ! theoradec ! ffmpegcolorspace ! pngenc snapshot=false ! multifilesink location="OUTPUT%04d.png"

===Transmux a MKV (containing vorbis and theora) to Ogg:===
*gst-launch filesrc location="INPUT.mkv" ! matroskademux name=d ! video/x-theora ! queue ! theoraparse ! oggmux name=mux ! filesink location="OUTPUT.ogv" d. ! audio/x-vorbis ! queue ! vorbisparse ! queue ! mux.

===Encode a y4m to lossless Dirac in Ogg:===
*gst-launch filesrc location="INPUT.y4m" ! decodebin ! schroenc force-profile=vc2_main rate-control=lossless ! oggmux ! filesink location="OUTPUT.ogv"

===Pull from a windows media stream, transcode to Ogg/Theora+Vorbis and send to a icecast server:===
(may require purchasing Fluendo plugins for decoding the encumbered codecs)
*gst-launch uridecodebin uri=mms://SOURCE.SERVER.COM/path name=d ! queue max-size-time=100000000 ! ffmpegcolorspace ! theoraenc bitrate=800 ! oggmux name=mux ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv d. ! queue max-size-time=100000000 ! audioconvert ! vorbisenc ! mux.

===Capture video from a webcam, encode to an Ogg Theora file, decode and display on screen, write to a file whose name is the current date+time, and stream to an IceCast server===
*gst-launch-0.10 --eos-on-shutdown v4l2src ! 'video/x-raw-yuv, width=640, height=480' ! videorate ! 'video/x-raw-yuv, framerate=15/1' ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=150 ! oggmux ! tee name=ogged ! queue max-size-bytes=100000000 max-size-time=0 ! oggdemux ! theoradec ! xvimagesink sync=false force-aspect-ratio=true ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=`date +%F_%T`.ogv ogged. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=YOURICECAST.SERVER.COM port=8000 password=YOURPASSWORD mount=/OUTPUTFILENAME.ogv streamname=YOURSTREAMNAME description=YOURDESCRIPTION genre=YOURGENRE url=YOURSTREAMURL ogged.

===A v4l2 source + ALSA source -> Ogg Theora -> IceCast===
*dov4l -i [0|1] -m NTSC
*gst-launch-0.10 --eos-on-shutdown v4l2src ! videoscale ! video/x-raw-yuv,width=320,height=240,framerate=30000/1001,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=400 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
:Note that the above pipeline will slowly lose audio/video synchronization due to hardware-level limitations in audio vs. video capture of media samples. FireWire and SDI-based capture does not have these limitations.

===Two v4l2 sources combined side-by-side into rectangular video + ALSA -> Ogg Theora -> IceCast===
*mplayer tv:// -tv device=/dev/video0:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*mplayer tv:// -tv device=/dev/video1:driver=v4l2:norm=NTSC:width=320:height=240:outfmt=uyvy:input=1:buffersize=16: -ao null
*gst-launch --eos-on-shutdown v4l2src device=/dev/video0 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! queue max-size-bytes=100000000 max-size-time=0 ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=15/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videomixer name=mix ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:1,0 latency-time=100 ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv v4l2src device=/dev/video1 ! videoscale ! video/x-raw-yuv,width=320,height=240,interlaced=true ! gamma gamma=1.2 ! queue max-size-bytes=100000000 max-size-time=0 ! videobalance saturation=1.9 brightness=0.00 contrast=1.4 hue=0.06 ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=5/1 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! videobox border-alpha=0 fill=green left=-320 ! mix.

===Create a video with an alpha channel from a sequence of PNG files===
*gst-launch-0.10 multifilesrc location=images%05d.png caps="image/png,framerate=1/1,pixel-aspect-ratio=1/1" num-buffers=95 ! pngdec ! videorate ! alphacolor ! "video/x-raw-yuv,format=(fourcc)AYUV" ! matroskamux ! filesink location=images_raw.mkv

===Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast===
*gst-launch --eos-on-shutdown ximagesrc ! capsfilter caps=video/x-raw-rgb,framerate=3/1,width=1680,height=1050 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-rgb, width=1056, height=660 ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 keyframe-auto=false keyframe-force=12 keyframe-freq=12 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=mux alsasrc device=hw:0,0 ! audio/x-raw-init,rate=44100,channels=1 ! queue max-size-bytes=100000000 ! audioconvert ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux. mux. ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=icecast-server.com password=hackme mount=/mountpoint.ogv
*Icecast will need to be built from SVN (ver. 2.3.2 fails to relay data due to a bug)
*Viewers will need better-than-average internet connectivity (around 1.5Mbits/sec)
*The simplest way to capture audio events is to place a mic next to computer speakers

===Live-stream a high-resolution Mac OSX Desktop at 1 FPS===
*Tested on Version 10.6.8, newer releases not compatible with [https://github.com/davibe/osximagesrc osximagesrc]

gst-launch --eos-on-shutdown osximagesrc ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! videoscale method=4-tap ! video/x-raw-yuv, width=960, height=600 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=360 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux ! queue max-size-bytes=100000000 max-size-time=0 ! shout2send ip=host.com password=hackme mount=/mountpoint.ogv

If the screen resolution is set to mirrored 1024x640 (?), start the following ''then'' plug in the video display cable:
*gst-launch --eos-on-shutdown osximagesrc ! queue max-size-time=0 max-size-bytes=100000000 ! ffmpegcolorspace ! queue max-size-time=0 max-size-bytes=100000000 ! videocrop right=256 top=32 ! queue max-size-time=0 max-size-bytes=100000000 ! videoscale ! video/x-raw-yuv, width=658, height=486 ! queue max-size-time=0 max-size-bytes=100000000 ! theoraenc bitrate=300 keyframe-auto=false keyframe-force=3 keyframe-freq=3 speed-level=0 drop-frames=false ! queue max-size-time=0 max-size-bytes=100000000 ! oggmux ! queue max-size-time=0 max-size-bytes=100000000 ! shout2send ip=host.com port=8000 password=hackme mount=/mountpoint.ogv

*Streamed Keynote talks will stream the Presenter's View -- no switching between display mirrors
*Full-screen Flash video doesn't stream, but doesn't halt the pipeline

===Live-stream an Elphel 353L camera, combine with on-laptop audio capture, save a high-res copy to disk, and view live video on-screen===
*Tested on an 2.4GHz Core i3 running at ≥2.0GHz. Both CPU cores should be at ~50% continuously-smooth utilization after the first ~15 seconds; battery-only power or overheating may throttle the CPU thus leading to dropped samples.
*Set the camera to 2592x1120 @ 18FPS. Adjust camera controls to ensure the camera achieves this framerate.
*Kill/renice any resource-competitive applications (file indexing services, Firefox, Audacity, etc.)
*qjackctl & → Start JACK in realtime priority

*gst-launch -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''halfres''' ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name='''jackaudio''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! mux.{{pad|1em}}'''mux.''' ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv{{pad|1em}}'''halfres.''' ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=450 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream '''jackaudio.''' ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream.{{pad|1em}}'''livestream.''' ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv{{pad|1em}}'''halfres.''' ! videoscale add-borders=true ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false
*Expect a ~50GB recording for 8hrs. of recording depending on image complexity (''e.g.'', filming a night sky vs. a waterfall). The Matroska recording may be viewed directly in VLC (≥2.0 recommended) and may be transcoded to commonly-used formats ''via'' [http://www.mirovideoconverter.com/ Miro Video Converter].

====Same as above, but simultaneously broadcast in H.264 ====
*Experimental; use latest git checkouts
*Tested with [http://www.rtmpd.com/ crtmpserver] (works) and [http://momentvideo.org/ Moment Video Server] (in theory)
:If Moment, remove 'pingTimerTick' 'from moment/rtmp_connection.cpp' to avoid stream resets
:Test stream availability with [http://dl.dropbox.com/u/2918563/flvplayback.swf this tool.]
:Toggle 'byte-stream=[true|false]' and '[tcpclientsink|rtmpsink]' as necessary, possibly '[flvmux|mp4mux]' if needed.
::'rtmpsink' isn't yet compatible with Akamai
*Substitute 'videotestsrc is-live=true' for 'rtspsrc ... jpegdec' and 'audiotestsrc freq=432' for 'jackaudiosrc connect=1' for testing.

*gst-launch-0.10 -e rtspsrc location=rtsp://192.168.0.9:554 latency=100 ! queue max-size-bytes=100000000 max-size-time=0 ! rtpjpegdepay ! queue max-size-bytes=100000000 max-size-time=0 ! jpegdec ! queue max-size-bytes=100000000 max-size-time=0 ! videorate ! video/x-raw-yuv,framerate=18/1 ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=1296, height=560 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=halfres ! queue max-size-bytes=100000000 max-size-time=0 ! jpegenc ! queue max-size-bytes=100000000 max-size-time=0 ! matroskamux name=mkvmux jackaudiosrc connect=1 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=jackaudio ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=vorbisaudio ! queue max-size-bytes=100000000 max-size-time=0 ! mkvmux. mkvmux. ! queue max-size-bytes=100000000 max-size-time=0 ! filesink location=elphel_recording_`date +%F_%T`.mkv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! videoscale ! video/x-raw-yuv, width=648, height=280 ! queue max-size-bytes=100000000 max-size-time=0 ! tee name=quarterres ! queue max-size-bytes=100000000 max-size-time=0 ! x264enc sliced-threads=true cabac=true intra-refresh=false quantizer=22 rc-lookahead=15 bitrate=600 tune=zerolatency byte-stream=false ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux streamable=true name=flvmux jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! audioconvert ! queue max-size-bytes=100000000 max-size-time=0 ! faac ! queue max-size-bytes=100000000 max-size-time=0 ! flvmux. flvmux. ! queue max-size-bytes=0 max-size-time=0 ! tcpclientsink host=127.0.0.1 port=6666 quarterres. ! queue max-size-bytes=100000000 max-size-time=0 ! theoraenc bitrate=600 speed-level=1 ! queue max-size-bytes=100000000 max-size-time=0 ! oggmux name=livestream jackaudio. ! queue max-size-bytes=100000000 max-size-time=0 ! vorbisenc ! queue max-size-bytes=100000000 max-size-time=0 ! livestream. livestream. ! queue max-size-bytes=0 max-size-time=0 ! shout2send ip=host.com port=[80|8000] password=hackme mount=/mountpoint.ogv halfres. ! queue max-size-bytes=100000000 max-size-time=0 ! ffmpegcolorspace ! queue max-size-bytes=100000000 max-size-time=0 ! xvimagesink sync=false

===Dump Stills From the Resulting High-Res Elphel Recording Into a Folder===
*gst-launch filesrc location=recording.mkv ! matroskademux ! videorate ! image/jpeg,framerate=1/10 ! multifilesink location="OUTPUT%04d.jpg"

*Remove any colons from the input filename to avoid BASH issues
*Change the framerate to control the time interval between image stills and number of produced stills
*No queue elements are necessary
*Results in a lot of disk I/O; solid state drives would be helpful here

GST cookbook

2012-05-03T13:24:13Z

GChriss: /* Live-stream a high-resolution Mac OSX Desktop at 1 FPS */ add 2nd pipeline + notes

GST cookbook

2012-02-27T05:56:08Z

GChriss: /* Live-stream an Elphel 353L camera */ note on other apps running, VLC 2.0

GST cookbook

2012-01-29T23:24:15Z

GChriss: /* How to extract images from the Elphel command */ new section

People

2011-12-06T02:07:45Z

GChriss: add self

This page is meant to help with nickname to person lookup. ''Nickname'' can be a mail alias, an IRC nick, or a Subversion user — in most cases several of these. Please help to fill this table. Keeping your own entry up to date is a good start.

{| border="1" cellspacing="1" cellpadding="4" width="100%"
|+ Who is who
! Nickname
! Real name
! Keywords
|-
| arkadini
| Arek Korbik
| Quicktime, XiphQT
|-
| ben
| Benjamin Gérard
| libao
|-
| BjornW
| Björn Wijers
| [[Spread Open Media]], [[XSPF]]
|-
| [[User:Conrad|conrad]]
| [http://blog.kfish.org/ Conrad Parker]
| see ''[[#nick_kfish|kfish]]''
|-
| derf
| [http://people.xiph.org/~tterribe/ Timothy B. Terriberry]
| theora, CELT, video
|-
| dllmain
| Sebastian Pipping
| see ''[[#nick_sping|sping]]'', nick not used anymore
|-
| doublec
| Chris Double
| firefox, theora, Mozilla
|-
| drac667
| Cristian Adam
| DirectShow, oggcodecs, Windows
|-
| [[User:GChriss|gchriss]]
| George Chriss
| gstreamer, Elphel, event videography
|-
| giles
| [http://people.xiph.org/~giles/ Ralph Giles]
| see ''[[#nick_rillian|rillian]]''
|-
| gmaxwell
| Gregory Maxwell
| Wikimedia, CELT, theora
|-
| [[User:Silvia|ginger]]
| Silvia Pfeiffer
| see ''[[#nick_nessy|nessy]]''
|-
| [[User:Imalone|imalone]]
| Ian Malone
| metadata
|-
| illiminable
| Zentaro Kavanagh
| DirectShow, dsfilters, Microsoft
|-
| [[User:Saoshyant|ivo]]
| Ivo Emanuel Gonçalves
| advocacy, [[Spread Open Media]], [[XSPF]], wiki mod, vorbis-tools
|-
| jack
| Jack Moffitt
| libao, treasurer, Icecast
|-
| jcoalson
| Josh Coalson
| FLAC author
|-
| j, j^
| Jan Gerber
| v2v, ffmpeg2theora, sysadmin
|-
| [[User:jmspeex|jmspeex]]
| Jean-Marc Valin
| speex, ghost, VoIP
|-
| jmworx
| Jean-Marc Valin
| see ''[[#nick_jmspeex|jmspeex]]''
|-
| JoeyBorn
| Joe Born
| neuros
|-
| karl
| Karl Heyes
| Icecast
|-
| [[User:Conrad|kfish]]
| [http://www.kfish.org/ Conrad Parker]
| annodex, fishsound, hogg, oggz, vorbis-tools
|-
| laser13
| Marcin Lubonski
| annodex, oggplay, win32
|-
| lgonze
| Lucas Gonze
| [[XSPF]]
|-
| lu_zero
| Luca Barbato
| RTP Vorbis, RTP Theora, Gentoo
|-
| maikmerten
| Maik Merten
| theora, java, macos
|-
| MikeS
| Michael Smith
| fluendo, gstreamer, sysadmin, IceS
|-
| Monty
| Christopher Montgomery
| see ''[[#nick_xiphmont|xiphmont]]''
|-
| msmith
| Michael Smith
| see ''[[#nick_mikes|MikeS]]''
|-
| nessy
| Silvia Pfeiffer
| annodex, vquence, sysadmin, CMML
|-
| ozone
| André Pang
| annodex, macos
|-
| pjones
| Peter Jones
| cdparanoia, redhat
|-
| rillian
| [http://people.xiph.org/~giles/ Ralph Giles]
| metadata, video, theora, MNG, sysadmin
|-
| ribamar
| Ribamar Santarosa
| etheora
|-
| Saoshyant
| Ivo Emanuel Gonçalves
| see ''[[#nick_ivo|ivo]]''
|-
| segher
| Segher Boessenkool
| vorbis, audio
|-
| shans
| Shane Stephens
| annodex, oggplay
|-
| silvia
| Silvia Pfeiffer
| see ''[[#nick_nessy|nessy]]''
|-
| [[User:sping|sping]]
| Sebastian Pipping
| [[XSPF]], [http://libspiff.sourceforge.net/ libSpiff], [http://validator.xspf.org/ XSPF Validator]
|-
| tterribe
| [http://people.xiph.org/~tterribe/ Timothy B. Terriberry]
| See ''[[#nick_derf|derf]]''
|-
| thomasvs
| Thomas Vander Stichele
| fluendo, flumotion, gstreamer
|-
| volsung
| Stan Seibert
| libao
|-
| xiphmont
| Christopher Montgomery
| vorbis, ghost, audio, Ogg, cdparanoia
|-
| zen
| Zentaro Kavanagh
| see ''[[#nick_illi|illi]]''
|-
|}

[[Category:Developers stuff]]

GST cookbook

2011-10-07T20:08:20Z

GChriss: /* Elphel 353L */ add notes on the resulting recording

GST cookbook

2011-10-06T17:58:26Z

GChriss: /* Elphel 353L */ add some sensible color-coding to improve digestibility

Template:Pad

2011-10-06T17:44:59Z

GChriss: create spacing template

GST cookbook

2011-10-06T17:02:24Z

GChriss: add a good shove in the right direction for anyone interested in Elphel

GST cookbook

2011-09-08T13:51:48Z

GChriss: /* Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast */ add mac desktop

GST cookbook

2011-05-12T19:16:15Z

GChriss: /* Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast */ reduced_resources actually exacerbate the slow-drag problem

GST cookbook

2011-05-12T18:09:18Z

GChriss: /* Capture from a 1680x1050 GNOME Desktop, Combine with ALSA -> Ogg Theora + Vorbis -> Icecast */ use capsfilter instead, _much_ better buffer handling

GST cookbook

2011-04-11T23:51:55Z

GChriss: /* Desktop streaming */ fix typo, add explanation on disabling window animations

GST cookbook

2011-03-28T06:58:35Z

GChriss: /* Capture from a 1680x1050 Desktop... */ kill accessiblity = better results

GST cookbook

2011-03-28T04:50:02Z

GChriss: /* Desktop capture, no audio -> Ogg Theora -> Icecast */ updates

GST cookbook

2011-03-16T21:09:51Z

GChriss: add live desktop broadcast; this is a fragile pipeline sensitive to changes in bitrate and FPS

GST cookbook

2011-03-01T19:07:48Z

GChriss: /* v4l2 (x2) */ drop the framerate on the 2nd stream (e.g., for use with a scan converter for presentation slides)

GST cookbook

2011-03-01T19:04:04Z

GChriss: add a new section on v4l2 side-by-side

GST cookbook

2011-03-01T16:52:34Z

GChriss: /* v4l2 -> icecast */ update for what I use, include color correction

GST cookbook

2011-02-01T20:24:51Z

GChriss: /* Capture video from a v4l2 device, encode to an Ogg Theora file, mux with an ALSA audio source with delayed audio for a/v sync, then stream to IceCast */ warning on loss of A/V sync

GST cookbook

2010-06-22T17:42:45Z

GChriss: /* Capture video from a v4l2 device, encode to an Ogg Theora file, mux with an ALSA audio source (=hw:1,0), then stream to an IceCast server */ adding 'latency-time' as this was hard to dig up

Talk:TheoraTestsuite

2010-06-03T13:12:06Z

GChriss: A/V sync reference files would be helpful

It'd be helpful to create test files that contain audio, to see how multiplexing affects player compliance. Most video on the web comes with audio; the new batch could be placed into an "OggTestsuite." I've been looking for a standards-compliant Ogg Vorbis+Theora file that contains both a dynamic visual reference pattern and audio tone that changes according to the timecode, but at exactly the same time, to stress-test A/V sync. Suggestions? [[User:GChriss|GChriss]] 13:12, 3 June 2010 (UTC)

GST cookbook

2010-05-18T12:19:45Z

GChriss: add-in an audio example

How to help

2010-03-22T03:39:25Z

GChriss: /* PR and organizational matters */ link to videoonwikipedia.org

__NOTOC__
This page is intended to collect ideas and areas where new participants can contribute to Xiph.org initiatives.
Because this is an open wiki not all of these points have been reviewed with core Xiph developers. It is always best to coordinate your efforts on the relevant Xiph mailing lists and IRC channels.

One of the best ways people can contribute is by using the tools and formats. This accomplishes two primary goals:
#By providing materials in free formats you help lower the barriers to adoption for others
#By using the tools you will discover problems which you can report contributing to further development and refinement

==OggDSF specific activities==
Directshow is the windows video codec API, OggDSF provides support for Vorbis/Theora/Speex/Flac and Ogg in directshow.

Places to discuss development: Theora mailing list; #theora on irc.freenode.net

*Testing. Much of the Xiph.org community are run various unix-like operating systems. While OggDSF is widely used, it isn't frequently used by much of the more experienced Xiph.org community and hasn't has sufficient scrutiny.

==Software outreach==
Xiph.org software often reaches users via other software. E.g. Few people run libtheora by itself, many people use libtheora through other tools like VLC, Firefox, or gstreamer. These tools are maintained by other projects but the reliability and robustness of the free format support in these applications is critical to the public's ability to use Xiph.org formats.

Relevant contribution areas:
#Testing, e.g. [[TheoraTestsuite]] and reporting bugs into the relevant bug trackers
#Cross porting features
#Updating tools to support the latest features in the Xiph.org implementations (e.g. two-pass encoding for video tools)

==Theora specific activities==
Places to discuss development: Theora mailing list; #theora on irc.freenode.net

*Identifying videos where 1.1 or 1.2-development (ptalarbvorm) produce significantly worse results than prior versions. (These case is important compared to "works worse than some random format" because the differences are more likely to be actionable rather than just chance consequences related to differences in the encoders overall behaviour)

*Decoder assembly optimization for additional platforms (MIPS64; PPC)
**Skills required: optimization and development experience on the relevant platform.

*Decoder general performance improvements
**Skills required: C language; Use of a profiler. Optionally: SIMD assembly on relevant platforms.

==Vorbis specific activities==
Places to discuss development: Vorbis mailing list; #vorbis on irc.freenode.net

*Identifying test samples where Vorbis encodings at very high quality are not completely transparent under careful listening tests.
*Identifying test cases that exemplify the improvements in the current AoTuV development. (Helps with AoTuV merging)
*Identifying test samples where Vorbis performs worse than other formats.

==Skeleton specific activities==
Places to discuss development: Theora mailing list; #theora on irc.freenode.net

==Liboggz specific activities==
Places to discuss development: Theora mailing list; #theora on irc.freenode.net

==Cortado specific activities==
Places to discuss development: Theora mailing list; #theora on irc.freenode.net

Cortado is contains Java implementation of Vorbis/Theora/Kate/Ogg and an applet that allows playback of these formats on the web. It is the most popular fallback for HTML5 Ogg video, allowing users on legacy browsers (as old as Netscape 4) to play modern web video.
* See the cortado todo: [[Cortado/todo]]

==Flash port of Theora==
There are several workable implementations of Vorbis for the flash virtual machine. An implementation of Theora would allow the creation of a flash applet which plays Ogg video. One possible tool for this would be Adobe Alchemy, a C to Flash compiler which can be used to compile libtheora for flash. Beyond the basic codec porting work there is significant effort required building a player infrastructure around them because the built-in flash video infrastructure are not available for user implemented codecs (unlike silverlight). This initiative is primarily hindered by the surprising lack of overlap between flash developers and people who care about unencumbered formats.

==Additional tools work==
*Build and refine fall-back tools for HTML5 video based on Cortado, Flash Vorbis, and the upcoming Silverlight applet support. Many existing fallback tools require users to adopt H.264, such tools are valuable for media providers who are willing and able to distribute H.264 but they are not useful for ones who are not, and they are not tools that Xiph can really stand behind.

==PR and organizational matters==
*Participate in external promotional activities such as [http://www.fsf.org/resources/formats/playogg PlayOgg!]
*[http://videoonwikipedia.org Contribute] to Wikipedia's video collection
*Locate media coverage regarding free formats and related areas and share it with the the mailing lists
*Encourage additional media distributors to support HTML5 with Theora

TheoraSoftwareEncoders

2009-08-24T15:37:02Z

GChriss: fix link

== Multi-platform ==
*[http://www.v2v.cc/~j/ffmpeg2theora/ ffmpeg2theora] a commandline encoder from any format read by ffmpeg to Theora/Vorbis: [http://svn.xiph.org/trunk/ffmpeg2theora/ svn], [http://www.v2v.cc/~j/ffmpeg2theora/download.html major releases], [http://firefogg.org/nightly/ very latest versions of ffmpeg2theora and some more stuff]
* [http://diracvideo.org/download/ffmpeg2dirac/ ffmpeg2dirac] - fork of ffmpeg2theora, can enode into OGG Dirac but also Theora
*[http://www.videolan.org/ VLC Media Player] Can transcode from any source it supports into Ogg/Theora. WARNING: Apparently creates broken Ogg streams.
*[http://gstreamer.freedesktop.org/ GStreamer] GStreamer is a library that allows the construction of graphs of media-handling components, ranging from simple Vorbis playback to complex audio (mixing) and video (non-linear editing) processing.
*[http://sarava.org/theorur/ Theorur] is a GUI for Ogg/Theora streaming (icecast2 system), written using gtk2.
*[http://handbrake.fr Handbrake] is a GUI/CLI free software for ripping/encoding DVD/Files into various containers and formats including theora & vorbis since September 2008.
*[http://firefogg.org/ firefogg] is a Firefox extension that encodes locally and uploads in chunks or when encoding finishes

== Windows ==
*[http://dir.visonair.tv/streamer.php Visonair.tv Ogg Streamer] A Windows application to stream directly from a webcam to an Icecast server.
*[http://www.visonair.tv/ Visonair.tv Virtual Stage] Includes an application to encode to Theora, forces fixed size and encoding parameters though. Registration required.
*[http://www.freewarefiles.com/program_6_227_33306.html GFrontend ffmpeg2theora] GUI Frontend for ffmpeg2theora
*[http://mediacoder.sourceforge.net/ MediaCoder] Application to encode media files into many target formats, including Theora.
*[http://www.erightsoft.com/ SUPER] General purpose converter application, also serves as a frontend to ffmpeg2theora.

== Linux/BSD ==
*[http://thoggen.net/ Thoggen] is a DVD backup utility ('DVD ripper') for Linux, based on GStreamer and Gtk+.
*[http://freej.org/ Freej] Freej is a realtime video mixer. It can stream Theora and Vorbis live to [http://icecast.org icecast]. Check [http://lab.dyne.org/FreejStreaming here] for more info.
* [http://oggconvert.tristanb.net/ OggConvert] is a small Gnome utility which uses GStreamer to convert (almost) any media file to Vorbis, Theora and Dirac.

== Mac OS X ==
*[http://xiph.org/quicktime XiphQT] allows you to export from Quicktime, or any application supporting Quicktime (i.e. Final Cut Pro), to Theora/Vorbis.
*[http://v2v.cc/~j/SimpleTheoraEncoder/ Simple Theora Encoder] an ffmpeg2theora frontend

== See also==
{{Template:Theora}}

[[Category:Theora]]

TheoraSoftwareEncoders

2009-08-24T15:36:23Z

GChriss: add firefogg

== Multi-platform ==
*[http://www.v2v.cc/~j/ffmpeg2theora/ ffmpeg2theora] a commandline encoder from any format read by ffmpeg to Theora/Vorbis: [http://svn.xiph.org/trunk/ffmpeg2theora/ svn], [http://www.v2v.cc/~j/ffmpeg2theora/download.html major releases], [http://firefogg.org/nightly/ very latest versions of ffmpeg2theora and some more stuff]
* [http://diracvideo.org/download/ffmpeg2dirac/ ffmpeg2dirac] - fork of ffmpeg2theora, can enode into OGG Dirac but also Theora
*[http://www.videolan.org/ VLC Media Player] Can transcode from any source it supports into Ogg/Theora. WARNING: Apparently creates broken Ogg streams.
*[http://gstreamer.freedesktop.org/ GStreamer] GStreamer is a library that allows the construction of graphs of media-handling components, ranging from simple Vorbis playback to complex audio (mixing) and video (non-linear editing) processing.
*[http://sarava.org/theorur/ Theorur] is a GUI for Ogg/Theora streaming (icecast2 system), written using gtk2.
*[http://handbrake.fr Handbrake] is a GUI/CLI free software for ripping/encoding DVD/Files into various containers and formats including theora & vorbis since September 2008.
*[http://firefogg.org/ firefogg is a Firefox extension that encodes locally and uploads in chunks or when encoding finishes]

== Windows ==
*[http://dir.visonair.tv/streamer.php Visonair.tv Ogg Streamer] A Windows application to stream directly from a webcam to an Icecast server.
*[http://www.visonair.tv/ Visonair.tv Virtual Stage] Includes an application to encode to Theora, forces fixed size and encoding parameters though. Registration required.
*[http://www.freewarefiles.com/program_6_227_33306.html GFrontend ffmpeg2theora] GUI Frontend for ffmpeg2theora
*[http://mediacoder.sourceforge.net/ MediaCoder] Application to encode media files into many target formats, including Theora.
*[http://www.erightsoft.com/ SUPER] General purpose converter application, also serves as a frontend to ffmpeg2theora.

== Linux/BSD ==
*[http://thoggen.net/ Thoggen] is a DVD backup utility ('DVD ripper') for Linux, based on GStreamer and Gtk+.
*[http://freej.org/ Freej] Freej is a realtime video mixer. It can stream Theora and Vorbis live to [http://icecast.org icecast]. Check [http://lab.dyne.org/FreejStreaming here] for more info.
* [http://oggconvert.tristanb.net/ OggConvert] is a small Gnome utility which uses GStreamer to convert (almost) any media file to Vorbis, Theora and Dirac.

== Mac OS X ==
*[http://xiph.org/quicktime XiphQT] allows you to export from Quicktime, or any application supporting Quicktime (i.e. Final Cut Pro), to Theora/Vorbis.
*[http://v2v.cc/~j/SimpleTheoraEncoder/ Simple Theora Encoder] an ffmpeg2theora frontend

== See also==
{{Template:Theora}}

[[Category:Theora]]

Talk:PortablePlayers

2009-06-18T14:05:21Z

GChriss: /* Humble A2 Review */

==TrekStor==
There are many more portable players by TrekStor than the i.beat 500 supporting ogg vorbis.

Please add products to the main page.

== LG players ==
I think LG's player MF-FM30 looks nice. BUT, does it have support for UMS (the products homepage doesn't say so so I guess not) or does there software work in Linux? Somebody who knows?
Hannulan - 23:48, 1 oktober 2006

== List of top five players ==
It would be a good idea to have a few (five?) players at the top with images that are considered to be the best *recent* devices. I don't think any of the MP3 using masses will use this page to choose their next music player unless it lists recent devices, and presents a choice of five or six at the top, with images, and links to sites that they can buy them from. Also, could someone put up a notice to remind people it's not OGG, or Ogg! It's Ogg Vorbis, or if you must, Vorbis. - thehumanerror 25th December 2006

I totally agree with the above. This page was next to useless for me when I was shopping for a Vorbis player since I was overwhelmed with choices. Add to that the fact that many products have been discontinued or cannot be bought new and there's a recipe for disaster. - erpo41 October 17th, 2007

I also agree with the above; the primary reason I am not using Ogg Vorbis (I keep a parallel collection of mp3 and flac files) is I cannot easily find a portable player. I don't know that reorganizing this wiki page will help. I did comb through this page; basically all of the listed hard disk players are from one off manufacturers or not being manufactured any more. There are plenty of nice flash storage based devices and cell phones (from Samsung and others), but that is not what I am looking for. Also, I'm not interested in hacking my iPod. (I do embedded linux development enough at work; I'll pay someone else to get my media player working). Until this is addressed, Ogg Vorbis is going to remain out of use; which is a shame because for every other reason it is the best (in my opinion). --Kevin Holzer, January 10, 2009

:Yes. This is a good idea. Create a section at the top. Polish it well. And perhaps add a free-licensed photo. Anyone up for it?--[[User:Saoshyant|Ivo]] 06:41, 17 October 2007 (PDT)

I would rather see just a simple feature matrix (sorted so that unavailable devices are listed at the bottom, or just not listed at all). See talk below. Maybe preferred choises could be raised to the top thought! I agree that current list is quite unusable.

== Recording in Vorbis ==

I would like to know which Players can '''record''' in Vorbis?! -- [[User:217.186.150.213|217.186.150.213]] 17:03, 26 Dec 2004 (PST)

:Ditto. Absolutely vital information. Do any of the players listed also record in Vorbis? If anyone has experience with A player, please state specifically whether it does or does not record in Vorbis.[[User:Nickhill|Nickhill]] 15:04, 4 June 2006 (PDT)

::Never heard of one that does, and there isn't a fixed point reference encoder, which makes it unlikely.

== Pretec Allegro may need firmware update ==

I recently purchased a Pretec Allegro, but was unable to play Oggs for three months, until the firmware update was made available on 14 or 15 March 2005. Now it works well! (So far, listening to -q3 Oggs). I'd hope that units purchased after this date already has the firmware update, but you never know. Installing the update is as simple as placing the .rom on the USB-storage-device media (eg flash disk), starting up the unit, and pressing the play button. -- Hugo van der Merwe
: How much battery runtime do you get playing Oggs compared with playing mp3? [[User:Phr|Phr]] 02:05, 27 Aug 2005 (PDT)

== Any player with Removable Memory Cards ==

The NexBlack (see [[PortablePlayers]] ) has removable compact flash and batteries.

Every single Vorbis-capable portable player out there seems to come with built-in flash memory. Which is stupid, because I don't want to fire up my computer and plug in the player every time I get tired of the tracks on my player. Plus flash memory has a limited lifetime (write cycles) and so does your player with built-in memory. The same applies for built-in rechargable batteries.

Now when would you ever need to buy your second device without any moving parts if you could just change flash memory and batteries? Ok, that's the industrie's point of view but not mine. I want to go on vacation with music and batteries for one week of non-stop music - without a power source or computer nearby.

So, any hint to where I might find a portable audio player that can play back ogg vorbis files and uses SD flash cards (and preferably AAA-batteries) would be greatly appreciated.
* Me too! If the [http://enox.co.kr/2004/eng/product/product_830_01.asp Enox EMX-830] took SD cards it'd be perfect. --[[User:Rgm|rgm]] 14:41, 7 Nov 2005 (PST)

* SanDisk Sansa e250/e260/e270/e280 has a microSD-card slot. With ROCKbox it plays Ogg/Vorbis and more.[[User:Nostromo|Nostromo]] 15:26, 29 October 2007 (PDT)

----

The Pretec Allegro is not the slickest player out there, it's LCD backlight seems to give off a high-pitched whine, which not everyone can hear (it kind-of screams in my ears though, so I put the backlight timer on 1 second so it doesn't scream too long). It is, however, the only one I now know of that can play Oggs, and uses removable media. If you want a nicely portable device, you have to use Pretec's "iDisk tiny" usb flash disk, the only thing that will fit inside. You can also, however, connect some USB SD-card reader with it's cable, then listen to Oggs off of SD. A little unwieldy, but, it works, and is the only thing *I* know of. (I stopped following developments in December though, when I bought it...)

== Samsung / Yepp ==

Moved to [[Talk:PortablePlayersSamsungYepp]]

== UniBrain iZak ==

Apologies if this is the wrong place for this; I'm new to wikis.

The UniBrain iZak was added, then removed recently, with the comment that it doesn't claim to play Ogg Vorbis.

The FAQ is available here: [http://www.unibrain.com/support/FAQ_iZak.htm iZak FAQ] and Question/Answer 24 says:

'22. Can iZak™ support OGG audio files?

Yes, iZak™ fully supports OGG playback using the latest firmware.'

:I was the one that removed it. In their specs linked from the main page, I saw that they listed only MP3 and WMA support for music formats. Obviously they need to update their promotional material! I went ahead and added the iZak back in, making a point to mention that the most current version of the firmware now supports Ogg Vorbis and linking to their FAQ as evidence. [[User:Saxifrage|Saxifrage]] 02:36, 5 May 2005 (PDT)

:Splendid. I didn't want to just stick it back after it had been taken out.--[[User:Ipl|Ipl]] 05:14, 5 May 2005 (PDT)

== Entempo Spirit ==

This inexpensive player from Entempo had listed Vorbis as a "Supported Audio Format", but the device will not index the Vorbis files into it's menus -- let alone play the files. Tested with both the stock and most recent firmware, May 29, 2005. Vendor had been contacted and removed Vorbis support claims from their website, but has not provided any resolution to customers which purchased the product expecting this support. The company's webpage has disappeared as of Feb 2006.

== Lexar LDP-800 dropped ==
It seems that Lexar have abondoned the LDP-800. The following was posted by a user on [http://www.dapreview.net/comment.php?comment.news.1055 dapreview.net]
" Unfortunately, lexar will not offer the LDP-800, but will focus instead
on its existing LDP Players that already offer appealing features and
benefits to meet a variety of consumer needs."
Shame.--[[User:Ipl|Ipl]] 06:15, 22 Jul 2005 (PDT)

There's more info on that dapreview thread that indicates some confusion within Lexar. Currently, it looks like the release is going to happen in early September.

Update 2005-11-11: after inquiries to Lexar's "new products" personnel, I received a telephone message that the LDP-800 will definitely "is not going to see the light of day." Ask me if you want details. I agree that it's a shame since this looked to be an outstanding product. --[[User:dfavro|dfavro]]

== Hong Kong Dream-tech Electronic DT-202, works? please confirm ==
http://hkdream-tech.com
An ebay seller says that it can reproduce Vorbis. This is unconfirmed. In the manufacturer web it says: MP3, WMA, WAV, DMV and etc.

Some webpage also says that it works on Windows, Mac and Linux. Also unconfirmed.
Further investigation required.

== Trekstor i.Beat Cube ==
This player seems to be very similar to the Samsung Yepp YP-T6, possibly with the [[#Yepp_MT-6X|same problems]] regarding Vorbis playback. Trekstor has moved [http://www.trekstor.de/en/produkte/mp3-player/ibeat-cube.html info about this player] from "MP3-Player" to the "Archive" section which propably means that it is not produced anymore.

== The Muzio jm300 / jm-300 does NOT play Vorbis ==

NB this is the jm-300 (not 100 or 200)

I bought this a month ago. I've been unable to play Vorbis files on
it. It simply shows these as 'etc' files and skips over them.

Pitty really, this was the main reason I chose this player.

I've seen lots of discussion about the muzio playing oggs, is there
anybody there who owns a jm300 and is actually playing oggs ? I can't
help think I've juts missed something basic.

== Layout of the PortablePlayers list and Feature matrix ==
It's gone! I've moved this discussion to [[Talk:PortablePlayersv2]]. [[User:Imalone|Imalone]] 10:55, 18 November 2006 (PST)

:Is there something very wrong with those proposals? I mean, is there any reason why (even a simple) feature matrix just could not be applied right now? It would probably solve 'list of top 5 players' problem above too. Just list something basic from the main features, name, size, weight, price, battery (internal, aa, aaa, ..), capasity, flash card type (sd, microsd, ..) , availability (current or discontinued), supported formats, charging (usb or propietary or none). Link to the longer comments. No complicated sorting or anything too fancy. No icons. Name can be a abbreviation to save space, use it as a link to current comments.

== NEXBlack out ==

I got my NEXBlack player today from Frontier Labs. It is a nice gadget with sleek design. They have corrected the occasional snap-sounds that came between tracks and it is overall more usable now. Vorbis-files also play fine, but the current firmware doesn't have Vorbis-tag reader, which is somewhat major drawback. The music selection works through mp3-tags and you can select by album, artist, genre and playlist, but since Vorbis tags won't work you have to select "unordered" to play them. Vorbis-files are all listed in one big list. I hope they either implement a Vorbis-tag reader or revert to old Nex IIe system where you could select by folder in the flash disc. But for the cheap price ($89), it is a good player... waiting for a new firmware..

== Sumvision M18/S1 ==

I've just got the 2GB Sumvision and it plays the OGG files I've tested so far. Should I add it to the list? [[User:Steevc|Steevc]] 04:05, 19 April 2007 (PDT)

== Humble A2 Review ==

Just a blog link [http://www.personal.psu.edu/gsc127/blogs/2007/10/happiness-with-cowon-a2.html to my review of the the Cowon A2]. Thanks, [[User:GChriss|GChriss]] 13:23, 6 November 2007 (PST)

== iRiver e100 ==

[http://reviews.cnet.com/4566-6490_7-0.html?filter=1000036_5260177_ CNet] and [http://www.amazon.com/iRiver-E100-Multimedia-Player-White/dp/B00171UYYS/ref=pd_bbs_sr_5?ie=UTF8&s=electronics&qid=1208253617&sr=8-5 Amazon] are saying the iRiver e100 supports Vorbis. I haven't tested it myself. [[User:Mattflaschen|Mattflaschen]] 03:09, 15 April 2008 (PDT)

== Bought an vorbis-enabled player recently? Tell us where! ==

I have started a page that should allow people easier purchasing of vorbis-enabled players: [[PortablePlayers_per_Place]]

Everyone, who bought an vorbis-enabled player recently should update the page with place and model.

== Move Flash/HD-sections to dedicated pages ==

Hi,

IMHO the PortablePlayers page is too long. I want to split it into several pages for each main section. Like [[PortablePlayers/Flash]], [[PortablePlayers/Harddisk]] etc.. Sure, one have to fix some links then, but I am convinced this step would increase the usability a lot.
What do you think about that? --[[User:Gsauthof|Gsauthof]] 01:20, 31 March 2009 (PDT)

User:GChriss

2007-11-06T21:28:50Z

GChriss: namespace redirect to my Wikipedia page

Please see my [http://en.wikipedia.org/wiki/User:GChriss Wikipedia] userpage. Thanks, [[User:GChriss|GChriss]] 13:28, 6 November 2007 (PST)