GETSTREAM(8) Lightweight DVB Streaming tool GETSTREAM(8)NAME
GETSTREAM - Lightweight DVB Streaming tool
SYNOPSIS
getstream [OPTION]
DESCRIPTION
GETSTREAM is a lightweight tool that streams a full DVB-S transponder into individual Multicast groups, one per program into the local area
network. symbol tables.
OPTIONS -d Start GetStream in debug mode.
-c config-file
Mandatory path to the configuration file. See the package documentation for examples.
SEE ALSO
Website <http://silicon-verl.de/home/flo/projects/streaming/>
AUTHOR
GETSTREAM was writter by Florian Lohoff <flo@rfc822.org>
This manual page was writter by Herve Rousseau <herve@moulticast.net>, for the Debian project (but may be used by others).
20070419 2007-06-06 GETSTREAM(8)
Check Out this Related Man Page
DVBSTREAM(1) Debian DVBSTREAM(1)NAME
dvbstream - Transmit a DVB transport stream via RTP
SYNOPSIS
dvbstream [ -f freq] [ -p vh] [ -s symbolrate] [ -c cardnum] [ -o ] [ -ps ] [ -i ipaddr ] [ -r port] [-a apid] [ -v vpid] p -t ttpid] [-n
secs ] [ pid1 ... ]
DESCRIPTION
dvbstream takes a TS (transport stream) from A DVB (Digital Video Broadcast, either DVB-S for satellite cards, DVB-C for cable, or DVB-T
for terrestrial) and broadcasts (a subset of) it over a LAN using the RTP protocol.
Some options are not available on Budget DVB cards.
OPTIONS -f The Frequency to tune into, in MHz.
-p, v|h
The polarisation; either h (horizontal) or v (vertical).
-s symbolrate
The symbol rate of the DVB stream, typically 27500.
-c cardnum
Select which DVB card to use. The cardnum must be between 0 and 3.
-a apid
Select which audio PID to output on the TV-OUT of the DVB card (Full cards only).
-v vpid
Select which video PID to output on the TV-OUT of the DVB card (Full cards only).
-t ttpid
Select which Teletext PID to output on the TV-OUT of the DVB card (Full cards only). -n secs Timeout and shut down after secs sec-
onds.
-ps Output a PS rather than a (default) PES stream.
-o Output to stdout rather than broadcast.
-i ipaddr
IP Multicast port to output to (default is 224.0.1.2)
-r port
IP multicast port to outpu to (default is 5004).
SERVER USAGE
If you wanted to broadcast TVC International from Astra 19E, you would type the following command:
dvbstream -f 12441 -p v -s 27500 512 660
You can specify up to 8 PIDs on the command-line to include in the multicasted transport stream. A 10MBit/s network should be able to han-
dle one video and one audio stream, or eight audio streams.
If you also want to view the TV channel on the TV-OUT of your DVB-S card (or using xawtv or similar), then you can use the "-v" and "-a"
flags before the video and audio PIDs respectively:
dvbstream -f 12441 -p v -s 27500 -v 512 -a 660
dvbstream also has the ability to map PIDS to different values before you stream it. For example, if you type
dvbstream -f 12441 -p v -s 27500 -v 512:1 -a 660:2
then the video stream will become "PID 1" and the audio stream will become "PID 2".
Also, with driver versions from October 2001 onwards, you can broadcast the entire transport stream (if you are using a budget card) with
the command:
dvbstream 8192
8192 is a "dummy PID" (legal PIDS are in the range 0-8191) and the driver interprets this to mean the entire TS. Obviously, it would make
no sense to use the map feature on this "pid".
CLIENT USAGE
To receive the stream on any other machine on your LAN, use the dumprtp utility (from ts-rtp). An slightly improved version is included in
this archive. e.g.
dumprtp > received.ts
If you have a DVB card on the second machine, you can use the rtpfeed command to decode the stream. Type "rtpfeed -h" for usage informa-
tion. rtpfeed was written by Guenter Wildmann <a8909020@unet.univie.ac.at> - please address any bugs or comments to Guenter.
If you don't have a DVB card on the client machine, You can use mpg123 and the mpegtools provided with the DVB driver for live audio decod-
ing:
dumprtp | ts2es apid | mpg123 -
This command line is included with dvbstream as the "rtpradio.sh" script.
If you only want audio, you can run dvbstream with eight audio PIDs, and then your clients can choose which PID to play.
For live TV channel playing, the best solution I have found is mplayer (http://www.mplayerhq.hu). Please install the latest CVS version -
mplayer is being rapidly improved.
You can then view TV being streamed over the network using the following command:
dumprtp | ts2ps vpid apid | mplayer -cache 2048 -
This command line is included with dvbstream as the "rtptv.sh" script.
MPLAYER RTP-PS SUPPORT
The file "mplayer-libmpdemux-network.c.patch" contains a patch for the current (31 Jan 2001) CVS version of mplayer to "enable" the experi-
mental RTP support. To apply it, check out a fresh copy of mplayer using and change into the "main/libmpdemux" directory.
Then apply the command:
patch < /path_to/dvbstream-0.4pre2/mplayer-libmpdemux-network.c.patch
You can then build mplayer as normal. To receive a RTP stream broadcast with dvbstream's "-ps" option, you just need to type the following
command on the client machine:
mplayer rtp://224.0.1.2:5004/ -cache 2048
TELNET INTERFACE
From v0.4 onwards, DVBstream incorporates a "telnet" interface to allow you to remotely start and stop the streaming, and tune the card to
a different channel.
The following commands are supported:
TUNE freq pol srate STOP ADDV pid[:map] ADDA pid[:map] ADDT pid[:map] ADD pid[:map] QUIT
STOP closes down all PIDs and stops the streaming. The other commands should be self-explanatory. See the scripts in the TELNET directory
for example usage. x
HISTORY
dvbstream fixes a number of bugs that were present in the original ts-rtp application.
SEE ALSO rtpfeed(1), dumprtp(1), and ts2es(1)AUTHORS
dvbstream was written by Dave Chapman <dave@dchapman.com> 2001, 2002. and is made available under the GNU Public License.
This man page was written by Alastair McKinstry, <mckinstry@computer.org>.
Linux 4 March 2005 DVBSTREAM(1)