gSUB 0.63

[hemertje]

Hi!.

 

Now its public at last!.

New version with Audio fix and some nice gSUB.channels,gSUB.audio files included:

 

gSUB - Subtitle application for Dreambox

========================================

 

Current version: 0.63, 2006-03-01

Author: Gruffy

Contact: gruffypuffy1234 AT hotmail DOT com

 

 

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 subtitles it will automatically start to show these.

 

System Requirements

-------------------

- 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.

 

Features includes...

--------------------

- 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, but not

tested as the developer is based in Sweden.

- Selectable position of text to allow for 16:9 or 4:3 TV sets.

- 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 suspen 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.

 

Planned upgrades

----------------

- Fixing Bugs bugs bugs...

- More suggestions???

 

Release notes

=============

0.63

----

- Fixed bug where audio settings did not work if the channel had no teletext.

 

0.62

----

- Changed the gSUB.channles setting to be in either OFF, FALLBACK or OVERRIDE mode.

OFF - Don't use the file at all

FALLBACK - Use the file if NO subs found.

OVERRIDE - Use the file BEFORE trying to find subs. Good for some wrongly coded

french channels for example.

- Fixed the scan crash bug...the bug is actually in Enigma, but this is a workaround

that probably is good enough. Let's hope for the best.

 

0.61

----

- Added GUI setting for enable/disable gSUB.audio

 

0.60

----

- Added support for audio selection through gSUB.audio file. Check in this

file for how to add audio selection.

 

0.59

----

- Rewritten how gSUB is launched/spawned totally.

gSUB is now both a "spawning daemon" as well as the "subtitle application".

Execute "gSUB --help" to see the options.

NOTE: You shall still autostart gSUB from init scripts with "gSUB &", this will

however start a gSUB starter daemon, and this will launch gSUB. The GUI will then

send signals to the daemon to start new instances when needed. Hopefully this will

help against the crashes of Enigma we have seen...

 

0.58

----

- Added translator table for french.

- Added new "Suspen While recording" option. Select between OFF/Sleep/Kill gSUB while

recording. The Kill option requires that you manually do a RESTART on it when recording

has finished and you want to use gSUB again.

 

0.57

----

- Fixed Disney channel bug.

- Fixed multilanguage selection, should improve spanish channels.

- Changed multithreading a bit...

- Added config option to enable/disable gSUB.channels file.

 

0.56

----

- Recompiled and changed plugin to handle the new CVS images that has the

changed "listbox" class.

 

0.55

----

- Changed internal code of gSUB to deal with slow WebIF better.

 

0.54

----

- Fixed channel change bug...was introduced when added language setting in

the gSUB.channels file.

- Changed Spanish translation table.

 

0.53

----

- Added language setting to gSUB.channels IMPORTANT!!! CHECK THIS FILE BELOW!

- Get rid of start_gSUB VERY IMPORTANT!!! NOT USED ANYMORE!

- Added "kill" button.

- Added Spanish charset.

 

0.52

----

- Fixed stupid crashbug in 0.51 GUI...argh...bad bad bad me!

 

0.51

----

- Fixed "clearing of subs" when changing channel

- Added "suspend while recording"

- Added web port selection (in file gSUB.conf only, not in GUI)

- Added support for Dutch, Spanish and Italian in GUI only. Will

probably render some chars incorrectly...as mentioned before, please

send these to me so that can implement a translation table!

 

0.50

----

- Changed how StartX, StartY etc are used. Also added a RowSpace feature.

- This release contains the first config plugin. Please test a lot for me!

- Got rid of libxmltree dependency...now runs good on 7020 again.

- Small bugs fixed.

 

 

Install

-------

Install the files into the following structure:

var/bin/gSUB <- Exefile

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

var/tuxbox/plugins/gSUBConf.cfg

 

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.

 

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!

 

 

Hidden features

===============

Disable gSUB subtitles by executing "touch /tmp/.gSUB_Disable" and reenable it again

by executing "rm /tmp/.gSUB_Disable". This is what the Enable/Disable in the gSUBConf

does. This feature could easily be implemented in other places in the GUI.

 

Summary: While there is a file "/tmp/.gSUB_Disable" the gSUB will NOT render anything

on the screen. Everything else is operating as usual.

 

 

gSUB.conf

=========

##

## gSUB Config file, Note that it is VERY case sensitive...be careful!

## For gSUB Version 0.63

## This file should be located at /var/tuxbox/config/gSUB/gSUB.conf

 

# Type 2 Subs, if TS supports it could be used as "5" for Hearing Impaired Subs as well... NOT TESTED!

SubtileType 2

 

# Language: tested with "swe", "dan", "fin" and "nor". NOT TESTED but implemented: german = "deu" or "ger"

Language swe

 

# Secondary Language: tested with "swe", "dan", "fin" and "nor". NOT TESTED but implemented: german = "deu" or "ger"

SecondLanguage eng

 

# Recording delay: When playing recored files a delay for when the subs are show is given here, in seconds.

RecDelay 2

 

# Suspend While Recording: Set this to 1 to have gSUB sleep while recording, 2 to Kill gSUB totally.

SuspendWhileRecording 2

 

# Adjust these to get the subs to move a little,

# X=0 and Y=0 gives a good pos for 4:3 TV's. To move up, use a negative Y-value, left is negative X value.

StartYPos 0

StartXPos 0

 

# This has higher priority than StartXPos...so if this is 1, the StartXPos is ignored

CenterText 1

 

# Palette index...for a standard enigma skin 24-31 is black faded to white (i.e. shades of gray)

TextColor 31

 

# Palette index...for a standard enigma skin 24-31 is black faded to white (i.e. shades of gray)

OutlineColor 24

 

# Use background instead of outline, i.e. the "black box"

UseBackground 1

 

# Font size, NOT height in pixels! If you change font test these out

FontSize 43

 

# Row Space, i.e the extra space between each row.

RowSpace 6

 

# The font you want to use, must be a True-Type font, i.e. end with .ttf

# Use /share/fonts/ or /var/share/fonts/ as paths. These are the ones used by gSUB Configurator.

Font /share/fonts/pakenham.ttf

 

# Enable/Disable External channels through gSUB.channels, 2- Enabled as override, 1-Enabled as fallback, 0-Disabled

UseExternalChannels 2

 

# Enable/Disable External audio settings through gSUB.audio, 1-Enabled, 0-Disabled

UseExternalAudio 1

 

# Login stuff...gSUB uses the WebIF to find out some things it needs...

WebLogin root

WebPassword dreambox

WebPort 80

 

 

gSUB.channels

==============

If you have a channel that is not displaying subs it might be a simple bug in

gSUB...if you suspect this, contact the author! But, it might also be so that

the subs are not announced correctly in the transport stream. If this is the

case, you can add this channel to the gSUB.channels file. What you need is the

Service ID (SID), the Teletext PID (VPID) and the subtitle page. SID & VPID can

be found by executing this in a browser: http://youriptothedreambox/cgi-bin/status

 

Note that the language setting in this file (gSUB.channels) only selects a charset for

gSUB so that it can handle special signs. You can still have other languages selected

as your default languages. I.e. you can have "Swedish" as first, "English" as second

language but still use "esl" or "fin" in gSUB.channels to get Spanish or Finish subs.

 

When you have the information...just add to gSUB.channels like this sample:

 

## gSUB.channels

## If the subs are not presented in the stream so that gSUB can find them.

## Simply add them here! MAKE SURE YOU ADD ServiceID and TeletextPID in hexadecimal numbers!

##

## This file should be located at /var/tuxbox/config/gSUB/gSUB.channels

##

## /Gruffy

##

 

## In this file, the SVT1 and SVT2 for the Boxer Network in Sweden is added as samples,

## but they are "disabled" by adding "##" in front of them!

## The text behind the numbers can be anything...it is NOT used by gSUB

 

## Syntax:

## SID(in hex) PID(in hex) PAGE(decimal) LANGUAGE(three letters) Whatever_you_like_can_come_here

 

## Sweden - Boxer

##3f2 3ec 199 swe - SVT1 for Boxer Network

##13ec 3ec 299 swe - SVT2 for Boxer Network

 

## Finland extra channels

11 242 451 fin - YLE TV1

21 242 452 fin - YLE TV2

91 242 453 fin - YLE Teema

81 242 454 fin - YLE24

51 242 771 fin - YLE FST

 

## Some Taq channels (Spanish) added for Taq. on 19.2 East

769 47 801 esl - Taq8

7567 38 801 esl - Taq7

7566 41 801 esl - Taq6

7565 20 801 esl - Taq5

7691 35 801 esl - Taq4

7690 41 801 esl - Taq3

768f 3e 801 esl - Taq2

768e 38 801 esl - Taq1

 

gSUB.audio

==========

Working like the gSUB.channels but used to set correct audio settings selection

for certain channels where you need to select, not only the PID but also LEFT/RIGHT

channel to get only one language.

 

## gSUB.audio

## This file should be located at /var/tuxbox/config/gSUB/gSUB.audio

## With this channel you can have gSUB to change audio settings

## SID = Service ID (same as in gSUB.channels)

## APID = Audio PID (Some channels will let you select between more than one AUDIO PIDs)

## CHANNEL = 0,1,2 (0=left, 1=stereo, 2=right)

##

## SID APID CHANNEL - Bla bla bla

35c 364 0 - Eurosport on Boxer network, Select left channel

 

More samples from Gaj:

======================

## Danish Audio, Canal Digital 1W

389 284 2 - Eurosport on Canal Digital Nordic, Select rigth channel

192 2bd 2 - Cartoon on Canal Digital Nordic, Select rigth channel

0ce 280 0 - Nickelodeon on Canal Digital Nordic, Select left channel

198 44e 0 - Jetix on Canal Digital Nordic, Select left channel

 

More samples from Kim:

======================

## Swedish Audio, Canal Digital 1W

192 2BE 0 - Cartoon Network on Canal Digital Nordic, Select left channel

198 44D 0 - Jetix on Canal Digital Nordic, Select left channel

0CE 281 0 - Nickelodeon on Canal Digital Nordic, Select left channel

389 284 0 - Eurosport on Canal Digital Nordic, Select left channel

##If not in use then delete or put ## in front of the line

 

Enjoy!.

1100233-gsubv0.63.zip