Chapter 2. Package Documentation

entrans — build and run GStreamer pipeline
Package Installation
Dependencies
Installation
Release History

See also the documentation for provided plug-ins

Package Installation

Dependencies

Definitely required:

python

well, only if you want to run entrans, but that is the idea …

GStreamer

At least gstreamer (core) and gst-plugins-base are needed, and for any comfortable operation the other modules as well; gst-plugins-good, gst-plugins-ugly, gst-plugins-bad and of course gst-ffmpeg. Of course, compiling these oneself may lead to more or less plug-ins, depending on the (e.g. codec) libraries actually installed.

Running entrans requires python bindings for GStreamer provided by PyGObject based on GObject Introspection (with some additional customizing overrides supplied by gst-python).

Optionally needed, e.g. if (re-)building documentation:

DocBook

This includes DocBook DTDs, and processing capability using Norman Walsh's DocBook XSL stylesheets. XML catalogs for the DTDs should also be setup (usually already taken care of by the installer/distro).

GTK-Doc

This is used to generate documentation for the plug-ins, and in turn depends on (a.o.) DocBook, python, pyxml, …

Installation

If necessary prerequisites are satisfied, then it suffices to unpack the tarball, then run ./configure, and then make, make install, as usual.

If you are using the GIT version, you will also need some autotools, and must run ./autogen.sh first.

The distributed tarball includes generated HTML pages, man pages and gtkdoc documentation. If you want to rebuild or install the gtkdoc part, you must pass --enable-gtk-doc to ./configure. Building from GIT by means of ./autogen.sh will do so by default. In any case, however, this then involves quite some additional dependencies (otherwise optional).

Similarly, passing --enable-docbook is required to rebuild the (current) HTML documentation, and additionally --enable-docbook2x is required to rebuild the manpage, neither of which is really recommended due to dependencies involved. However, this is not needed simply to have man pages installed from a distributed tarball,

Release History

GEntrans 1.0.1. 

  • improve parallel installability with 0.10 version

  • additional fix for 1.x ref handling

GEntrans 1.0.1. 

  • make stamp really GStreamer 1.x compatible

  • enhance stamp to optionally interpolate existing timestamps

  • additional 1.x PTS/DTS behavioural adjustments; new tsdup element, tweaks to shift, bufferjoin

  • miscellaneous code cleanups, build and test fixes

GEntrans 1.0.0. 

  • ported to GStreamer 1.0

GEntrans 0.10.4. 

  • support for encoding profile based transcoding using encodebin

  • more gstreamer -good native muxers now selected by default based on file extension

  • adjustments to upgraded or deprecated core API and behaviour

  • liboil dependency removed

  • miscellaneous build fixes, e.g. also support Win32 building

  • various code cleanups, minor bug fixes and documentation updates

GEntrans 0.10.3. 

  • fix possible entrans hang due to pygobject mainloop signal handling in python 2.6

  • build fixes and adjustments to upgraded or deprecated API

  • various code cleanups and documentation updates

GEntrans 0.10.2. 

  • additional filter elements (ported from AviDemux2)

  • build fixes and adjustments to upgraded or deprecated API

  • capssetter element enhanced and moved to upstream

  • tags are now converted to their expected value type

  • misc. updates and fixes

GEntrans 0.10.1. 

  • make entrans.py also multiqueue and queue2 aware

  • allow re-ordering of input streams to output streams

  • processing pipeline can now also be provided per specific stream (rather than only per type of stream)

  • seek for selected sections no longer restricted to FORMAT_TIME; now also possible in terms of a custom format (e.g. DVD chapter)

  • monitor for e.g. no-more-pads time-out, and try to correct/simulate

  • new generic element bufferjoin: joins subsequent buffers with identical timestamps (e.g. codec sequence headers and subsequent frame)

  • recognize and support some more container format file extensions

  • upgrades and adjustments to deprecations and new bindings

  • misc. updates and fixes

GEntrans 0.10.0. 

  • Initial release: collection of plugins and python based transcoding command line tool.