162 lines
7.0 KiB
Plaintext
162 lines
7.0 KiB
Plaintext
This is an IPTV plugin for the Video Disk Recorder (VDR).
|
|
|
|
Written by: Rolf Ahrenberg
|
|
< R o l f . A h r e n b e r g @ s c i . f i >
|
|
|
|
Antti Seppälä
|
|
< a . s e p p a l a @ g m a i l . c o m >
|
|
|
|
Project's homepage: http://www.saunalahti.fi/~rahrenbe/vdr/iptv/
|
|
|
|
Latest version available at: http://www.saunalahti.fi/~rahrenbe/vdr/iptv/
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License version 2 as
|
|
published by the Free Software Foundation.
|
|
See the file COPYING for more information.
|
|
|
|
Requirements:
|
|
|
|
DVB compatible MPEG1/2 or H.264 network video streams.
|
|
|
|
Description:
|
|
|
|
This plugin integrates multicast IPTV transport streams seamlessly into
|
|
VDR. You can use any IPTV channel like any other normal DVB channel for
|
|
live viewing, recording, etc. The plugin also features full section
|
|
filtering capabilities which allow for example EIT information to be
|
|
extracted from the incoming stream.
|
|
|
|
Currently the IPTV plugin has direct support for both multicast UDP/RTP
|
|
and unicast HTTP MPEG1/2 transport streams. Also a file input method is
|
|
supported, but a file delay must be selected individually to prevent
|
|
VDR's transfer buffer over/underflow. Therefore the file input should be
|
|
considered as a testing feature only.
|
|
|
|
IPTV plugin also features a support for external streaming applications.
|
|
With proper helper applications and configuration IPTV plugin is able to
|
|
display not only MPEG1/2 transport streams but also other formats like
|
|
MP3 radio streams, mms video streams and so on.
|
|
|
|
Installation:
|
|
|
|
cd /put/your/path/here/VDR/PLUGINS/src
|
|
tar -xzf /put/your/path/here/vdr-iptv-X.Y.Z.tgz
|
|
ln -s iptv-X.Y.Z iptv
|
|
cd /put/your/path/here/VDR
|
|
cp -R PLUGINS/src/iptv/iptv /path/to/vdrconf/plugins/
|
|
make
|
|
make plugins
|
|
./vdr -P iptv
|
|
|
|
Setup menu:
|
|
|
|
- TS buffer size [MB] = 2 Defines ringbuffer size for transport
|
|
stream in MB.
|
|
Valid range: 1...4
|
|
- TS buffer prefill ratio [%] = 0 Defines prefill ratio for transport
|
|
stream ringbuffer before data is
|
|
transferred to VDR.
|
|
Valid range: 0...40
|
|
- EXT protocol base port = 4321 Defines base port used in EXT protocol.
|
|
The port range is defined by the number
|
|
of IPTV devices (max. 8).
|
|
Valid range: 0...65527
|
|
- Use section filtering = 1 Defines whether section filtering shall
|
|
be used.
|
|
Valid range: 0...1
|
|
- Disable filters = 0 Certain section filters might cause some
|
|
unwanted behaviour to VDR such as time
|
|
being falsely synchronized etc. This
|
|
option allows creation of blacklists of
|
|
ill-behaving filters. If this option is
|
|
set to a non-zero value, the menu page
|
|
will contain that many "Disable filter"
|
|
options which allow you to disable the
|
|
individual section filters.
|
|
Valid range: 0...7
|
|
- [Blue:Info] Opens IPTV information/statistics menu.
|
|
|
|
Information menu:
|
|
|
|
- [Red:General] Opens the general information page.
|
|
- [Green:Pids] Opens the pid statistics page.
|
|
- [Yellow:Filters] Opens the section filter statistics page.
|
|
- [Blue:Bits/bytes] Toggles between bits and bytes mode.
|
|
|
|
Configuration:
|
|
|
|
- channels.conf
|
|
|
|
TV4;IPTV:40:S=1|P=0|F=EXT|U=iptvstream.sh|A=0:I:0:0:680:0:0:4:0:0:0
|
|
TV3;IPTV:30:S=0|P=1|F=FILE|U=/video/stream.ts|A=5:I:0:514:670:2321:0:3:0:0:0
|
|
TV2;IPTV:20:S=0|P=1|F=HTTP|U=127.0.0.1/TS/2|A=3000:I:0:513:660:2321:0:2:0:0:0
|
|
TV1;IPTV:10:S=1|P=0|F=UDP|U=127.0.0.1|A=1234:I:0:512:650:2321:0:1:0:0:0
|
|
^ ^ ^ ^ ^ ^ ^
|
|
| | | | | | Source type ("I")
|
|
| | | | | Stream parameter (multicast port
|
|
| | | | | number, HTTP port number, file delay
|
|
| | | | | (ms), script parameter)
|
|
| | | | Stream address (multicast address, URL, file
|
|
| | | | location, script location)
|
|
| | | Stream protocol ("UDP", "HTTP", "FILE", "EXT")
|
|
| | PID Scan ("0" disable, "1" enable)
|
|
| SID Scan ("0" disable, "1" enable)
|
|
Unique enumeration
|
|
|
|
- UDP multicast rules for iptables firewall
|
|
|
|
# Multicast UDP -packets
|
|
iptables -A INPUT -i eth0 -p udp -d 224.0.0.0/4 --dport 1234 -j ACCEPT
|
|
|
|
# IGMP required by multicasts
|
|
iptables -A INPUT -i eth0 -p igmp -d 224.0.0.0/4 -j ACCEPT
|
|
|
|
External streaming:
|
|
|
|
- To watch an externally received channel add an EXT entry to channels.conf
|
|
and specify a script name and parameter. The specified script is executed
|
|
from plugin configuration directory when VDR tunes to the channel. The
|
|
specified script parameter is passed to the script and it can be used to
|
|
select for example between different URLs.
|
|
|
|
- When an EXT channel is opened the IPTV plugin opens an UDP listening port
|
|
on the localhost. The external script is responsible for supplying IPTV
|
|
plugin with MPEG2 TS data in UDP/RTP format to the listening port. The
|
|
data will be processed in VDR like a normal DVB broadcast. The listening
|
|
base port can be specified in the plugin configuration menu.
|
|
|
|
- Each IPTV device has different listen port. The port number is specified
|
|
as a base port number plus IPTV device index minus one. Maximum of 8 IPTV
|
|
devices can be used simultaneously.
|
|
|
|
- IPTV plugin includes an example script which uses VLC media player for
|
|
receiving streams, transcoding and handing the result to IPTV plugin.
|
|
|
|
Notes:
|
|
|
|
- Working EIT requires correct Nid/Tid/Sid values as the NIT filter cannot
|
|
determine the type (satellite/cable/terrestrial) of the IPTV transport
|
|
stream.
|
|
|
|
- The following section filters are recommended to be disabled:
|
|
"NIT (0x40)", "SDT (0x42)", "TDT (0x70)"
|
|
|
|
- The IPTV devices look for a "/tmp/vdr-iptv<devicenumber>.dvr" fifo at
|
|
startup. If the fifo is found and succesfully opened, the device writes
|
|
the current data stream into it. This can be used for debugging purposes.
|
|
|
|
- Multiple channels with identical service id should have frequency
|
|
difference of 4 or greater. It's recommended to use frequencies in decades
|
|
(10, 20, 30, 40, ...) for all IPTV channel entries.
|
|
|
|
- VLC processes won't get killed on some setups with the provided iptvstream.sh
|
|
script and the iptvstream-notrap.sh script should be used instead in these
|
|
cases.
|
|
|
|
Acknowledgements:
|
|
|
|
- The IPTV section filtering code is derived from Linux kernel.
|
|
|
|
- The pid scanning code is derived from Udo Richter's streamplayer plugin.
|