README

   1 TELETEXT SERVER
   2 ===============
   3
   4 Installation
   5 ------------
   6
   7 1. `./install.sh` as root
   8 2. create `freqlist.conf` (see example in `src/`)
   9 3. `scan -a $ADAPTERNO freqlist.conf > channels.conf`
  10 4. use `ttxd.service` or `serv.sh` to start the service.
  11
  12 Usage
  13 -----
  14
  15 1. run `serv.sh` to tune the TV card and start spooling pages
  16 2. generate an HTML file by running `index.pl`
  17
  18 Caveats
  19 -------
  20
  21  * The spool directory and DVB adapter number are hardcoded in `dvbtext`; its source is in `./src/dvbtext-src/dvbtext.c`.
  22  * `index.pl`, `html.pl` and `plain.pl` do not support subpages other than 0.
  23  * `serv.sh` does not check if the card has been tuned; it simply waits 5 seconds.
  24  * The spool directory is `/run/ttxd/spool/`, to avoid disk wear.
  25  * The accompaning systemd service is `/etc/systemd/system/ttx.service`, where the names of the processes `dvbtext`, `tzap`, and `thttpd` are hardcoded.
  26  * 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.
  27
  28 Notes
  29 -----
  30
  31 Currently, the service is using `/dev/dvb/adapter0` (PCIe 05:00.0) for ORF via DVB-T.
  32
  33 License
  34 -------
  35
  36 (C) 2017 Tobias Girstmair
  37 This software is distributed under the GNU General Purpose License 3.
  38
  39 Included Software
  40 -----------------
  41
  42 This package contains software of third parties (excluded from license):
  43  * dvbtext - Dave Chapman, GNU GPL v2+ (software sightly adapted)
  44  * vtx2ascii - Gerd, Martin Buck (No license supplied) (software sightly adapted)
  45  * thttpd - Jef Poskanzer, 2 clause BSD (modified)