gSUB - Subtitle application for Dreambox
What is gSUB?
This is a subtitle application for the Dreambox Set-Top-Boxes by Dream Multimedia TV Gmbh. It should be installed
onto your box and put into an "init" script so that it automatically starts when you start the box. Then, when you
select a channel with Teletext or DVB subtitles it will automatically start to show these.
- Enigma based firmware in the Dreambox. Should work with any Dreambox model but the author is using a DM500T for
development, and this is hence the only box it is tested on.
- A Busybox with the "wget" command available. gSUB is using the WebIF to get some information from the Enigma and at the
time of this release it was using the "wget" internally. This is up for change and this requirement will be removed in
some future releases...maybe :-) Check in your /bin directory for a symlink "wget" to Busybox.
- NOTE! IT WILL NOT WORK ON NEUTRINO BASED IMAGES! This is because gSUB is using the Enigma web interface (WebIF) to get
information from the Enigma application.
- It will NOT work on MIPS based Dreamboxes such as the DM7025.
- This release will try and use the /tmp/pmt.tmp to get zapping faster an non-dependant on WebIF.
If you have an image without this (PLi Flabber for example) gSUB will fallback to using the WebIF,
and in this case, the WebIF is required.
- Using TrueType fonts for displaying, using one color with outline. (White text, black outline is default.)
- Detecting if playing a recorded file and in this case a "delay" is added to get the subtitles into sync. (The time of
this delay is controlled through the gSUB.conf file.)
- Avoid to display subtitles if any Enigma window is detected.
- Selectable language, tested with Swedish, Norwegian, Danish, Finish and English. Implemented German, Dutch, Italian,
French and Spanish but not tested as the developer is based in Sweden. However tested by others!
- Selectable position of text to allow for 16:9 or 4:3 TV sets.
- Support for different settings for 4:3 or 16:9 transmissions.
- Selectable size of font.
- Use background (black blob behind text) or not.
- Center/Left adjustment of text.
- Basic settings accessed through Enigma plugin.
- Advanced settings are controllable through a file, gSUB.conf.
- Automatic suspend/kill during recording to conserve CPU power.
- Hardcoded channels in file gSUB.channels so that the user can show gSUB what language
it shall use when translating chars.
- Support for audio pid /audio channel selection through gSUB.audio
- Autostart enable/disable through GUI.
- NEW: DVB Subtiles included!!!
- Only using WebIF for Audio changes, a lot less spam on Enigma...
Install the files into the following structure:
var/bin/gSUB <- Exefile for DAEMON (must be installed here!!!)
var/bin/2SUB <- Exefile for APPLICATION (must be installed here!!!)
var/etc/init <- init script that is starting gSUB
These lines of code could be moved into other start scripts
for example the ones used in 7020 images /etc/init.d/bootmisc.sh
var/tuxbox/config/gSUB/gSUB.conf <- config file for gSUB
var/tuxbox/config/gSUB/gSUB.channels <- config file for channels
var/tuxbox/config/gSUB/gSUB.audio <- config file for audio settings
var/tuxbox/plugins/gSUBConf.so <- The gSUB Configurator plugin
NOTE! The included "init"-file is only containing the start of gSUB. If you have something else in your setup you should
merge the lines for starting gSUB into your "init" script. See "Advanced info about autostart" below.
Also, make sure that the font pointed to by the gSUB.conf is existing on your system. If you would like to use your own font,
simply point to it with the gSUB.conf and restart gSUB. Make sure it contains the characters for your language!
Language: The gSUB is implementing "translations" of special chars for different languages. This is done for the languages
defined above. Note that it is possible to select a non existing language in the conf file. If this is a correct language
code in the Teletext standard it should come up, but special characters are not shown. If you want this inside gSUB, make
notes about the displayed characters and what you were expecting and send it to the author. Maybe it will make it into the
next version of gSUB!
Supported & Tested languages: Swedish, Danish, Finnish, Norwegian, French, German, Dutch, Spanish, Italian and English.
Important: If you have changed your WebIF login/password/port you must edit these things in the gSUB.conf file. This
could be done with a UNIX editor or from the gSUB Configurator GUI.
Advanced info about autostart
When gSUB is started from an init script, it should be started with something like:
This will start a gSUB daemon that is then used by the plugin to spawn new instances of the gSUB subtitle application.
To manually start a subtitle application without the daemon use "gSUB -nodaemon" from the command line prompt.
Below you can see how this is done in the "init" file.
----------- CUT FROM "init" ------------
if [ -x /var/bin/gSUB ]; then
----------- END CUT FROM "init" --------
N O T E ! ! !
THIS IS DIFFERENT ON ALL IMAGES USED! CHECK THE DETAILS OF YOUR IMAGE OR ASK ON THE FORUMS FOR A REPACKED
VERSION OF GSUB FOR YOUR IMAGE! IF YOU INSTALL WRONG PACKAGE YOU MIGHT END UP WITH A FAULTY IMAGE AS THE
GSUB PACKAGE M