src/dvbtext-src/README

   1 DVBtext - version 0.1
   2 ---------------------
   3
   4 CONTENTS OF THIS FILE:
   5 ----------------------
   6
   7 1. INSTALLATION
   8 2. USAGE
   9 3. AUTHOR AND CONTACT DETAILS
  10 4. COPYRIGHT NOTICE
  11
  12
  13 1. INSTALLATION
  14 ---------------
  15
  16 1) Modify the root spool directory (VTXDIR) at the start of dvbtext.c
  17    and the path to the DVB/ost/include directory from the driver source.
  18
  19 2) Compile the application by typing "make".
  20
  21 3) Create your spool directory and 8 subdirectories numbered "1" to "8"
  22    within that directory.  i.e.
  23
  24         mkdir /video/vtx
  25         cd /video/vtx
  26         mkdir 1 2 3 4 5 6 7 8
  27
  28    Obviously, these need to be writable by the user you run dvbtext as.
  29
  30 4) [Move the dvbtext executable into your path - e.g. /usr/local/bin]
  31
  32 NOTE: DVBtext uses the DVB driver's "new api".  You need to have the
  33 correct devices created under /dev/ost/.  If you don't have these, run
  34 the "makedev.napi" script in the DVB/driver directory.
  35
  36
  37 2. USAGE
  38 --------
  39
  40 1) Tune your DVB card to a channel - e.g. using VDR.
  41 2) Run dvbtext with a list of teletext PIDs for all the channels on the same
  42    transponder as your tuned channel.
  43
  44 e.g. Tune to ARD (11837h, sr: 27500, vpid: 101, apid:102) on Astra
  45 19E.  Then type:
  46
  47 dvbtext 104 204 304 404 504 604 704 804
  48
  49 to spool the teletext pages for ARD, BR3, Hessen-3, ARTE, SR3, WDR,
  50 BR-alpha and SWR BW simultaneously.
  51
  52 You can then view a page from your console using (for example) the
  53 vtx2ascii program (contained in the oldstuff/vtx directory of the
  54 xawtv source).
  55
  56 e.g. vtxc2ascii -c /video/vtx/1/100_00.vtx
  57
  58 Displays a colour (text-only) version on an ANSI capable terminal.
  59
  60 A channels.conf file for VDR (version 0.71pre2 or above) including
  61 teletext PIDs for many channels on Astra 19 is included with DVBtext.
  62 The teletext PID is the third field from the end - after the video and
  63 audio PIDs.
  64
  65 NOTE: VDR and DVBtext can happily run together.  However, you will
  66 need to stop and restart dvbtext with different parameters when you
  67 change channels.
  68
  69
  70 3. AUTHOR AND CONTACT DETAILS
  71 -----------------------------
  72
  73 DVBtext was written by Dave Chapman <dave@dchapman.com>.  The latest
  74 version is always available from CVS at
  75 http://sourceforge.net/projects/dvbtools/
  76
  77 The project home page and released versions of the program can be
  78 found at http://www.linuxstb.org.
  79
  80 Thanks to Ralph Metzler for developing the DVB driver, the vbidecode
  81 package (on which, DVBtext is based), and for answering my questions.
  82
  83
  84 4. COPYRIGHT NOTICE
  85 -------------------
  86
  87 This program is free software; you can redistribute it and/or modify
  88 it under the terms of the GNU General Public License as published by
  89 the Free Software Foundation; either version 2 of the License, or
  90 (at your option) any later version.
  91
  92 This program is distributed in the hope that it will be useful,
  93 but WITHOUT ANY WARRANTY; without even the implied warranty of
  94 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  95 GNU General Public License for more details.
  96
  97 You should have received a copy of the GNU General Public License
  98 along with this program; if not, write to the Free Software
  99 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.