A teletext to plain text converter and viewer - the Twitter of editorial news.
C Roff Makefile Shell Perl C++ HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
LICENSE
ORFText.cgi
README
channels.conf
html.pl
install.sh
serv.sh
ttxd.service

README

TELETEXT SERVER - DVB-T2 Version
================================

Updated to work with DVB-T2 and the Astrometa DVB-T2 USB Stick; many improvements in `html.pl`.

Installation
------------

1. `./install.sh` as root
2. create channels.conf with `w_scan` or others; I'm using VDR format    
   `w_scan -a /dev/dvb/adapter0/frontend1 -cAT -vv > channels.conf`
4. use `ttxd.service` or `serv.sh` to start the service.

Usage
-----

1. run `serv.sh` to tune the TV card and start spooling pages
2. generate an HTML file by running `ORFText.cgi`

Notes and Caveats
-----------------

 * The Astrometa DVB-T2 is very iffy: make sure firmware (`dvb-demod-mn88473-01.fw`) is in place and monitor dmesg when connecting/tuning (I2C errors, firmware upload). 
   Only fix seems to be a manual reconnect (TODO: splice relay into 5V wire of USB cable)
 * `dvbtext` had the line `if (buf[4+i*46]==2) {` replaced with `if (buf[4+i*46]==3) {` or no vtx files will be generated
 * The spool directory and DVB adapter number are hardcoded in `dvbtext`; its source is in `./src/dvbtext-src/dvbtext.c`.
 * `serv.sh` does not check if the card has been tuned; it simply waits 5 seconds.
 * The spool directory is `/run/ttxd/spool/`, to avoid disk wear.
 * The accompaning systemd service is `/etc/systemd/system/ttx.service`, where the names of the processes `dvbtext`, `tzap`, and `thttpd` are hardcoded. 
 * since `killall thttpd` is used to start and stop the service, rename that executable if you already running an instance of `thttpd` for other web services.
 * in VDR format, teletext PIDs are directly visible: `awk -F':' '{if ($8 != 0){print $1, " : ", $8}}' channels.conf|column -t -s':'`

Notes
-----

Currently, the service is using `/dev/dvb/adapter0/{frontend1,demux0}` (USB) for ORF via DVB-T2. 

License
-------

(C) 2017 Tobias Girstmair
This software is distributed under the GNU General Public License 3. 

Included Software
-----------------

This package contains software of third parties (excluded from license): 
 * dvbtext - Dave Chapman, GNU GPL v2+ (software sightly adapted)
 * vtx2ascii - Gerd, Martin Buck, GNU GPL v2(+?) (software sightly adapted)
 * thttpd - Jef Poskanzer, 2 clause BSD (modified)
 * tzap-t2 - Igor M. Liplianin, GNU GPL v2+ (used as-is)