Uusin tekstityssofta: Gsub

Raitsa · 13.2.2006

Uusin tekstityssofta: Gsub

Hi All!.

I have the pleasure of introducing a new Subtitle Plugin, as The Author Gruffy now decided to make it public.

PS: Remember to uninstall bullz_text or take the start line out in your init/bootmisc.sh. For Gemini Images delete the bullz_text file in var/bin/. Else this one will not start.

Here from the gSUB_README file:

gSUB - Subtitle application for Dreambox
========================================

Current version: 0.50, 2006-02-13
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.

Planned upgrades
----------------
- Fixing Bugs bugs bugs.
- Hardcoded channels for using when subs are not announced in stream.
- More languages when I get some feedback on that.
- More suggestions???

Release notes
=============
- 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/bin/start_gSUB <- The start file for gSUB, MUST BE USED AS PLUGIN NEEDS IT!
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 bootmisc.sh
var/tuxbox/config/gSUB/gSUB.conf <- config file
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
=========
Here is the default gSUB.conf file displayed:
============================================
##
## gSUB Config file, Note that it is VERY case sensitive.be careful!
## For gSUB Version 0.50
##

# 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

# 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

# Login stuff.gSUB uses the WebIF to find out some things it needs.
WebLogin root
WebPassword dreambox

Please enjoy this brand new Plugin, you will be amazed!.

Thanks Gruffy for your great work.

Raitsa · 14.2.2006