Chapter 2. Package Documentation

entrans — build and run GStreamer transcoding pipeline
enplayer — GStreamer media/pipeline player
Package Installation
Dependencies
Running uninstalled
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).

HotDoc

This is used to generate documentation for the plug-ins in the meson build.

Running uninstalled

enplayer can be run uninstalled as long as enplayer is also present in the same directory, which could be added to the PATH for convenience. enplayer could also be run uninstalled, though some features might be missing as they require elements supplied by the package's plugins.

Installation

If necessary prerequisites are satisfied, then the usual sequence applies to build either using tarball or the GIT version:

meson build .
ninja -C build install

The distributed tarball includes generated HTML pages, man pages and plugins documentation. So in that case the included parts are re-used rather than rebuilt, and as such requires less dependencies. The use_dist option allows to disable that, whereas the doc option controls generation of (manual and plugins) documentatation. The default setting will decide based on the available dependencies.

Release History

GEntrans 1.4.3.  This is the first release of GEntrans that only supports building using meson.

  • autotools build system removed

  • various fixes to enplayer and entrans, some related to python3 port

  • enhancements to enplayer (e.g. seek relative to end, copy position to clipboard) and entrans (e.g. loading of presets)

GEntrans 1.4.2.  This is the first release of GEntrans that supports building using meson. The autotools build system will be removed in a subsequent version.

  • meson build system added

  • minor fixes to enplayer and entrans

  • code style adjustments

GEntrans 1.4.1. 

  • minor fixes to enplayer and entrans python3 port

GEntrans 1.4.0.  This is the first release of GEntrans using python3.

  • enplayer and entrans ported to python3

  • various minor build warning fixes

  • minor maintenance on documentation build system

GEntrans 1.2.3.  This will be the last release of GEntrans using python2.

  • updates on enplayer media player, e.g. OSD CSS and handling of playlist

GEntrans 1.2.2. 

  • updates on enplayer media player, e.g. enable/disable subtitle rendering

  • updates to gtk-doc building of plugin documentation

GEntrans 1.2.1. 

  • minor fixes on the recently added enplayer media player

  • aligning and namespacing of plugin names and library sonames

GEntrans 1.2.0. 

  • a plain though versatile enplayer media player has been added which provides player functionality to suppplement entrans's transcoding capabilities

  • a new element entransalsavolume has been added, providing optional additional ALSA convenience when using enplayer in an ALSA context

  • namespacing of debug category and element factory names using a configure-time determined prefix (default set to entrans)

  • minor adjustments to entrans to provide shared code support for enplayer

GEntrans 1.0.4. 

  • add tag filtering capability to dam

  • various build fixes and documentation updates

  • all element GType names are now prefixed with GstEntrans

  • optional namespacing of debug category and element factory names using a configure-time determined prefix; in subsequent (minor) release this prefix will default to entrans (and might then break existing element references if not overridden)

  • improved handling of multi-valued options in configuration file

  • configuration file now also searched for in XDG specified location ($HOME/.config)

  • miscellaneous fixes and some refactoring of entrans in preparation of next release

GEntrans 1.0.3. 

  • minor fixes to msharpen element and entrans script

  • replace some deprecated pygobject constructs

  • upgrade build setup to newer autotools and GStreamer

GEntrans 1.0.2. 

  • improve parallel installability with 0.10 version

  • additional fix for 1.x ref handling

GEntrans 1.0.1. 

  • make entransstamp really GStreamer 1.x compatible

  • enhance entransstamp 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.