
How to use bullz_text (Hopefully you know linux)

FTP to dreambox
bullz_text.cfg =>  /var/etc/bullz_text.cfg  (ascii)
bullz_text     =>  /var/bin                 (binary)
sub_title.so   =>  /var/tuxbox/plugins      (binary)
sub_title.cfg  =>  /var/tuxbox/plugins      (ascii)
  and optionally (One fnt file is built in)
bullz_text.fnt =>  /var/etc/bullz_text.fnt  (binary)

Before you make the ftp transfer you can edit
the configuration file at your wish. Please
use an editor which can handle Unix text or
execute DOS2UNIX after the edit
  (http://www.lesve.org/zip/UDDU.ZIP
	from bastet.com)

The colors of the subtitle is configurable. Either
you write the raw value or one of the preconfigured.
The raw value is an integer between 0 and 65535

It is also possible to edit the font file, bullz_text.fnt.
Normally this is not the case but if you want to do
this you have the utility Softy.
  (http://www.lesve.org/zip/sfty107b.zip
	[No support today])
In case you edit the file. Do not change anything else
than the pixels (No size or order)

Next you open a telnet connection to your dreambox and do the following
 > cd /var/bin
 > chmod 511 bullz_text    # or chmod 733 for less security
 > ./bullz_text
 >

If you for some reason want to suspend the text output for some time
you can do that by creating the file /tmp/suspend_bullz_text
The size is unimportant. Through telnet you do this
with the command 'touch /tmp/suspend_bullz_text'
To deactivate the suspend just delete the file and the text should be there again.
telnet command for delete: 'rm /tmp/suspend_bullz_text'
It is also possible to suspend through the config file (See bullz_text.cfg)

In case you will start it at boot, just edit the file /var/etc/init.
Add the following line at the end of that file (but before 'exit' if that exist)
Important: Dont forget any character

if [ -x /var/bin/bullz_text ]; then /var/bin/bullz_text; fi

bullz_text has also some command line options (which overide config file)
 -h             A little help
 -b             Let the program run as background (default from version 0.16)
 -f             Let the program run as forground
 -v		Change output from console to stderr (your terminal)
                Will only work in forground mode
 -d <level>	Change the debug level. (<level> can be 0 - 3)
 -l <lang)      Sets the country code (dan,fin,nor,swe,ita,eng)

More features in the 'bullz_text.cfg' file

bullz_text can reread the file /var/etc/bullz_text.cfg and change
some parameters during run time. To change parameters just edit the
file and when you have finished editing just run the script
 '/var/bin/cfg_bullz_text'.

The only parameters which are read and changed during this are:
(The same as the GUI)
language:
language2:
colorindex:
delta_y:
audio_change:
suspend:

GUI PLUGIN:
-----------
The GUI plugin can be started from the plugin menu.

1st Language: Change to the prefered language of your choice
2nd Language: Change to the language you choose if your prefered dont exist
Color:  Setting the foreground and background color of the characters
At Boot: Setting startuo sequnce in /var/etc/init
Audio:  Setting 'Audio select channel'
Suspend: Stopping the application without killing it
START:  Press green button to start bullz_text
STOP:   Press red button to abport bullz_text
CHANGE: Press blue button when you want to update your configuration
ABOUT:  Press yellow button you will see version number and if you
	are connected to internet even the latest released version of bullz_text.
	Some status information about the running bullz_text

example:
Up: 84 s. Channel up: 4 s
Language: swe (691) - No timestamp
Available: swe nor dan fin
	Up:		Telling how long bullz_text has been executed
	Channel up:	Telling the uptime for the current channel
	- No timestamp:	Current channel has no timestamp
	- Silent:	Current channel has no text for the choosen language
                        until now
	Language: None	No choosen language is available

Important
=========
To abort the program just type '/var/bin/kill_bullz_text' in a telnet window
and a clean abort is executing. Do NOT use kill (or killall).

The program is using the Console for Notice, Warnings and Errors.
You can read the Console through a nullmodemcable to your PC. (just 115200 bps 8N1)

If you don't have this you can change in the configuration file or use command
line option (-v). If you run in background it will if force the messages to
console all the time.

Known limitations and bugs
  The size of the subtitle is not changable.
  When changing the channel is the new setting delayed.
  The GUI doesnt work for rudream (Lame buuton do not work)

The home page for the subtitle program is:
	http://www.lesve.org/main.php?folder=dreambox&db=3

If you find unpleasent bugs please tell me at
the following address bullz_text@lesve.org and
hopefully make an attechment of a log.
The best way to get a log for debugging is to start the bullz_text
with the command 'bullz_text -f -v -d 3' through telnet connection.

Change Log:
2004.10.26 0.28 Dutch Language and suspend in GUI-if
2004.10.14 0.27 German as new Language
2004.09.28 0.26 Even try change Audio
2004.09.18 0.25 New Language French
2004.09.12 0.24 Syncronize text on/off in config file
2004.09.06 0.23 Status in the GUI configuration (About key)
2004.08.31 0.22 Part II of the GUI configuration
2004.08.27 0.21 New Language Italien and first GUI try
2004.08.22 0.20 Added the suspend possibilty
2004.08.04 0.19 Compiled with  gcc version 'gcc-3.3.4'
2004.07.30 0.18 Better solution for Hallmark(1W) subtitle
2004.07.24 0.17 Possible to reread bullz_text.cfg
2004.07.12 0.16 Withdraw
2004.07.12 0.15 Options: move lines up/down
2004.07.04 0.14 Added a font color (Outlined white).
2004.06.29 0.13 Buildin command to run in background
2004.06.26 0.12 Will work on Hydra Ulysses 1.08
2004.06.19 0.11 Can now handle a secondary language
2004.06.17 0.10 Change code at channel change
2004.06.14 0.09 Read http port from enigma config
2004.06.12 0.08 Add command line options
2004.06.11 0.07 The colours are configurable
2004.06.09 0.06 An option to have the font as a seperate file 
2004.06.06 0.05 Change the code for error correction (Hamming code)
2004.06.02 0.04 Add the trace possibility in the configuration
2004.05.31 0.03 Language configuration
2004.05.31 0.02 Complete font. No nordic character yet
2004.05.29 0.01 Very first try
