dvbstream/dvbstream.1

   1 .TH DVBSTREAM "1" "4 March 2005" "Linux" "Debian"
   2 .SH NAME
   3 dvbstream \- Transmit a DVB transport stream via RTP
   4 .SH SYNOPSIS
   5 .B dvbstream [\fI \-f freq\fR] [\fI \-p v\|h\fR] [\fI \-s symbolrate\fR]
   6 [\fI \-c cardnum\fR] [\fI \-o \fR] [\fI \-ps \fR]
   7 [\fI \-i ipaddr \fR] [\fI \-r port\fR]
   8 [\fI\-a apid\fR] [\fI\ -v vpid\fR] p\fI \-t ttpid\fR] [\fI\-n secs \fR] [\fI pid1 ... \fR]
   9
  10
  11 .SH DESCRIPTION
  12 .B dvbstream
  13 takes a TS (transport stream) from A DVB (Digital Video Broadcast, either
  14 DVB-S for satellite cards, DVB-C for cable, or DVB-T for terrestrial) and
  15 broadcasts (a subset of) it over a LAN using the RTP protocol.
  16 .TP
  17 Some options are not available on Budget DVB cards.
  18 .SH OPTIONS
  19 .TP
  20 \fB\-f\fR
  21 The Frequency to tune into, in MHz.
  22 .TP
  23 \fB\-p\fR, \fI v|h\fR
  24 The polarisation; either \fIh\fR (horizontal) or \fIv\fR (vertical).
  25 .TP
  26 \fB\-s\fR \fIsymbolrate\fR
  27 The symbol rate of the DVB stream, typically 27500.
  28 .TP
  29 \fB\-c\fR \fIcardnum\fR
  30 Select which DVB card to use. The \fIcardnum\fR must be between 0 and 3.
  31 .TP
  32 \fB\-a\fR \fIapid\fR
  33 Select which audio PID to output on the TV-OUT of the DVB card (Full cards only).
  34 .TP
  35 \fB\-v\fR \fIvpid\fR
  36 Select which video PID to output on the TV-OUT of the DVB card (Full cards only).
  37 .TP
  38 .TP
  39 \fB\-t\fR \fIttpid\fR
  40 Select which Teletext PID to output on the TV-OUT of the DVB card (Full cards only).
  41 \fB\-n\fR \fIsecs\fR
  42 Timeout and shut down after \fIsecs\fR seconds.
  43 .TP
  44 .TP
  45 \fB\-ps\fR
  46 Output a PS rather than a (default) PES stream.
  47 .TP
  48 \fB\-o\fR
  49 Output to stdout rather than broadcast.
  50 .TP
  51 \fB\-i ipaddr\fR
  52 IP Multicast port to output to (default is 224.0.1.2)
  53 .TP
  54 \fB\-r port\fR
  55 IP multicast port to outpu to (default is 5004).
  56
  57 .SH SERVER USAGE
  58
  59 If you wanted to broadcast TVC International from Astra 19E, you would
  60 type the following command:
  61 .sp
  62 dvbstream -f 12441 -p v -s 27500 512 660
  63 .sp
  64 You can specify up to 8 PIDs on the command-line to include in the
  65 multicasted transport stream.  A 10MBit/s network should be able to
  66 handle one video and one audio stream, or eight audio streams.
  67 .PP
  68 If you also want to view the TV channel on the TV-OUT of your DVB-S
  69 card (or using xawtv or similar), then you can use the "-v" and "-a"
  70 flags before the video and audio PIDs respectively:
  71 .sp
  72 dvbstream -f 12441 -p v -s 27500 -v 512 -a 660
  73 .sp
  74 dvbstream also has the ability to map PIDS to different values before
  75 you stream it.  For example, if you type
  76 .sp
  77 dvbstream -f 12441 -p v -s 27500 -v 512:1 -a 660:2
  78 .sp
  79 then the video stream will become "PID 1" and the audio stream will
  80 become "PID 2".
  81 .PP
  82 Also, with driver versions from October 2001 onwards, you can
  83 broadcast the entire transport stream (if you are using a budget card)
  84 with the command:
  85 .sp
  86 dvbstream 8192
  87 .sp
  88 8192 is a "dummy PID" (legal PIDS are in the range 0-8191) and the
  89 driver interprets this to mean the entire TS.  Obviously, it would
  90 make no sense to use the map feature on this "pid".
  91
  92 .SH CLIENT USAGE
  93
  94 To receive the stream on any other machine on your LAN, use the
  95 dumprtp utility (from ts-rtp).  An slightly improved version is
  96 included in this archive. e.g.
  97 .sp
  98 dumprtp > received.ts
  99 .sp
 100 If you have a DVB card on the second machine, you can use the rtpfeed
 101 command to decode the stream.  Type "rtpfeed -h" for usage
 102 information.  rtpfeed was written by Guenter Wildmann
 103 <a8909020@unet.univie.ac.at> - please address any bugs or comments to
 104 Guenter.
 105 .PP
 106 If you don't have a DVB card on the client machine, You can use mpg123
 107 and the mpegtools provided with the DVB driver for live audio
 108 decoding:
 109 .sh
 110 dumprtp | ts2es apid | mpg123 -
 111 .sh
 112 This command line is included with dvbstream as the "rtpradio.sh" script.
 113 .PP
 114 If you only want audio, you can run dvbstream with eight audio PIDs,
 115 and then your clients can choose which PID to play.
 116 .PP
 117 For live TV channel playing, the best solution I have found is mplayer
 118 (http://www.mplayerhq.hu).  Please install the latest CVS version -
 119 mplayer is being rapidly improved.
 120 .PP
 121 You can then view TV being streamed over the network using the
 122 following command:
 123 .sp
 124 dumprtp | ts2ps vpid apid | mplayer -cache 2048 -
 125 .sp
 126 This command line is included with dvbstream as the "rtptv.sh" script.
 127
 128 .SH MPLAYER "RTP-PS" SUPPORT
 129
 130 The file "mplayer-libmpdemux-network.c.patch" contains a patch for the
 131 current (31 Jan 2001) CVS version of mplayer to "enable" the
 132 experimental RTP support.  To apply it, check out a fresh copy of
 133 mplayer using and change into the "main/libmpdemux" directory.
 134 .PP
 135 Then apply the command:
 136 .sp
 137 patch < /path_to/dvbstream-0.4pre2/mplayer-libmpdemux-network.c.patch
 138 .sp
 139 You can then build mplayer as normal.  To receive a RTP stream
 140 broadcast with dvbstream's "-ps" option, you just need to type the
 141 following command on the client machine:
 142 .sp
 143 mplayer rtp://224.0.1.2:5004/ -cache 2048
 144 .sp
 145
 146 .SH TELNET INTERFACE
 147
 148 From v0.4 onwards, DVBstream incorporates a "telnet" interface to
 149 allow you to remotely start and stop the streaming, and tune the card
 150 to a different channel.
 151 .PP
 152 The following commands are supported:
 153 .PP
 154 .sp
 155 TUNE freq pol srate
 156 STOP
 157 ADDV pid[:map]
 158 ADDA pid[:map]
 159 ADDT pid[:map]
 160 ADD pid[:map]
 161 QUIT
 162 .sp
 163
 164 .I STOP
 165 closes down all PIDs and stops the streaming.  The other commands
 166 should be self-explanatory.  See the scripts in the TELNET directory
 167 for example usage.
 168 x
 169 .SH HISTORY
 170 .B dvbstream
 171 fixes a number of bugs that were present in the original
 172 .B ts-rtp
 173 application.
 174
 175 .SH "SEE ALSO"
 176 .BR rtpfeed (1),
 177 .BR dumprtp (1),
 178 and
 179 .BR ts2es (1)
 180
 181 .SH AUTHORS
 182 .B dvbstream
 183 was written by  Dave Chapman <dave@dchapman.com> 2001, 2002.
 184 and is made available under the GNU Public License.
 185 .PP
 186 This man page was written by Alastair McKinstry, <mckinstry@computer.org>.
 187