2007-10-14 21:37:34 +02:00
|
|
|
|
This is an IPTV plugin for the Video Disk Recorder (VDR).
|
2007-09-12 19:28:59 +02:00
|
|
|
|
|
2007-10-12 17:10:54 +02:00
|
|
|
|
Written by: Rolf Ahrenberg
|
|
|
|
|
< R o l f . A h r e n b e r g @ s c i . f i >
|
2007-10-12 13:03:58 +02:00
|
|
|
|
|
2007-10-12 17:10:54 +02:00
|
|
|
|
Antti Sepp<70>l<EFBFBD>
|
|
|
|
|
<a j h s e p p a @ n i k s u l a . h u t . f i >
|
2007-09-12 19:28:59 +02:00
|
|
|
|
|
|
|
|
|
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
|
2007-10-13 15:06:17 +02:00
|
|
|
|
it under the terms of the GNU General Public License version 2 as
|
|
|
|
|
published by the Free Software Foundation.
|
2007-09-12 19:28:59 +02:00
|
|
|
|
See the file COPYING for more information.
|
|
|
|
|
|
2007-09-14 23:49:47 +02:00
|
|
|
|
Requirements:
|
|
|
|
|
|
2007-10-14 20:45:34 +02:00
|
|
|
|
An IPTV patched VDR-1.5.10 (or later) setup and DVB compatible MPEG1/2
|
2007-10-12 17:10:54 +02:00
|
|
|
|
network video streams.
|
2007-09-14 23:49:47 +02:00
|
|
|
|
|
2007-09-12 19:28:59 +02:00
|
|
|
|
Description:
|
|
|
|
|
|
2007-09-14 23:49:47 +02:00
|
|
|
|
This plugin integrates multicast IPTV transport streams seamlessly into
|
|
|
|
|
VDR. You can use any IPTV channel like any other normal DVB channel for
|
2007-10-12 23:43:18 +02:00
|
|
|
|
live viewing, recording, etc. The plugin also features full section
|
2007-10-13 00:52:46 +02:00
|
|
|
|
filtering capabilities which allow for example EIT information to be
|
2007-10-12 23:43:18 +02:00
|
|
|
|
extracted from the incoming stream.
|
2007-09-14 23:49:47 +02:00
|
|
|
|
|
2007-10-12 17:10:54 +02:00
|
|
|
|
Currently the IPTV plugin supports both multicast UDP/RTP and unicast
|
2007-10-12 17:15:45 +02:00
|
|
|
|
HTTP MPEG1/2 transport streams. Also a file input method is supported,
|
2007-10-12 17:10:54 +02:00
|
|
|
|
but a file delay must be selected individually to prevent VDR's transfer
|
2007-10-13 00:52:46 +02:00
|
|
|
|
buffer over/underflow. Therefore the file input should be considered
|
|
|
|
|
as a testing feature only.
|
2007-10-07 17:56:52 +02:00
|
|
|
|
|
2007-09-14 23:49:47 +02:00
|
|
|
|
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
|
2007-10-14 20:45:34 +02:00
|
|
|
|
patch -p1 < PLUGINS/src/iptv/patches/vdr-X.Y.Z-pluginparam.patch
|
2007-09-15 01:37:50 +02:00
|
|
|
|
cp sources.conf /path/to/vdrconf/
|
2007-10-20 18:02:11 +02:00
|
|
|
|
cp -R PLUGINS/src/iptv/iptv /path/to/vdrconf/plugins/
|
2007-09-14 23:49:47 +02:00
|
|
|
|
make
|
|
|
|
|
make plugins
|
|
|
|
|
./vdr -P iptv
|
|
|
|
|
|
2007-10-08 01:00:10 +02:00
|
|
|
|
Setup menu:
|
2007-10-07 17:56:52 +02:00
|
|
|
|
|
|
|
|
|
- TS buffer size [MB] = 2 Defines ringbuffer size for transport
|
|
|
|
|
stream in MB.
|
2007-10-12 23:43:18 +02:00
|
|
|
|
Valid range: 1...4
|
2007-10-07 17:56:52 +02:00
|
|
|
|
- TS buffer prefill ratio [%] = 0 Defines prefill ratio for transport
|
|
|
|
|
stream ringbuffer before data is
|
|
|
|
|
transferred to VDR.
|
|
|
|
|
The valid range: 0...40
|
|
|
|
|
- Use section filtering = 1 Defines whether section filtering shall
|
|
|
|
|
be used.
|
2007-10-12 23:43:18 +02:00
|
|
|
|
Valid range: 0...1
|
2007-10-07 17:56:52 +02:00
|
|
|
|
- Scan Sid automatically = 1 Defines whether service id shall be
|
|
|
|
|
scanned automatically. Requires section
|
|
|
|
|
filtering.
|
2007-10-12 23:43:18 +02:00
|
|
|
|
Valid range: 0...1
|
|
|
|
|
- Disable filters = 0 Certain section filters might cause some
|
2007-10-13 00:52:46 +02:00
|
|
|
|
unwanted behaviour to VDR such as time
|
2007-10-12 23:43:18 +02:00
|
|
|
|
being falsely synchronized etc. This
|
|
|
|
|
option allows creation of blacklists of
|
|
|
|
|
ill-behaving filters. If this option is
|
2007-10-13 00:52:46 +02:00
|
|
|
|
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.
|
2007-10-12 23:43:18 +02:00
|
|
|
|
Valid range: 0...7
|
2007-10-09 18:37:16 +02:00
|
|
|
|
- [Red:Channels] Opens IPTV channel editor.
|
|
|
|
|
- [Blue:Info] Opens IPTV information/statistics menu.
|
|
|
|
|
|
|
|
|
|
Channel editor menu:
|
|
|
|
|
|
2007-10-13 00:52:46 +02:00
|
|
|
|
- Because of the different nature and content the VDR channel editor is not
|
|
|
|
|
best suited for editing of IPTV channels. Therefore an alternative editor
|
|
|
|
|
is provided which allows more IPTV centric editing of channel information.
|
|
|
|
|
An IPTV channel editor is accessible via "Setup -> Plugins -> IPTV" and
|
|
|
|
|
pressing the Red button. The channel editor is functionally similar to
|
|
|
|
|
VDR's built-in channel editor.
|
2007-10-09 18:37:16 +02:00
|
|
|
|
|
|
|
|
|
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.
|
2007-10-07 17:56:52 +02:00
|
|
|
|
|
|
|
|
|
Configuration:
|
|
|
|
|
|
|
|
|
|
- channels.conf
|
|
|
|
|
|
2007-10-20 00:54:03 +02:00
|
|
|
|
TV4;IPTV:4:IPTV|EXT|iptvstream.sh|0:P:0:0:680:0:0:4:0:0:0
|
|
|
|
|
TV3;IPTV:3:IPTV|FILE|/video/stream.ts|5:P:0:514:670:2321:0:3:0:0:0
|
2007-10-07 17:56:52 +02:00
|
|
|
|
TV2;IPTV:2:IPTV|HTTP|127.0.0.1/TS/2|3000:P:0:513:660:2321:0:2:0:0:0
|
|
|
|
|
TV1;IPTV:1:IPTV|UDP|127.0.0.1|1234:P:0:512:650:2321:0:1:0:0:0
|
|
|
|
|
^ ^ ^ ^ ^ ^
|
|
|
|
|
| | | | | Source type ("P")
|
2007-10-19 23:36:27 +02:00
|
|
|
|
| | | | IP Port Number, File delay (ms), Script parameter
|
|
|
|
|
| | | IP Address, File location, Script location
|
2007-10-17 00:13:44 +02:00
|
|
|
|
| | Protocol ("UDP", "HTTP", "FILE", "EXT")
|
2007-10-07 17:56:52 +02:00
|
|
|
|
| Plugin ID ("IPTV")
|
|
|
|
|
Unique enumeration
|
|
|
|
|
|
|
|
|
|
- UDP multicast rules for iptables firewall
|
2007-09-16 15:36:10 +02:00
|
|
|
|
|
|
|
|
|
# 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
|
2007-10-12 01:34:27 +02:00
|
|
|
|
|
|
|
|
|
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)"
|
2007-10-13 15:06:17 +02:00
|
|
|
|
|
2007-10-20 00:18:55 +02:00
|
|
|
|
- The EXT protocol listens UDP packets from localhost. The default listen
|
|
|
|
|
port base number is 4321 and it can be configured via a commandline
|
|
|
|
|
switch. The port range is defined by the number of IPTV devices (max. 8).
|
|
|
|
|
|
2007-10-20 00:54:03 +02:00
|
|
|
|
- The EXT protocol scripts must be located in the config directory of the
|
|
|
|
|
plugin.
|
|
|
|
|
|
2007-10-13 15:06:17 +02:00
|
|
|
|
Acknowledgements:
|
|
|
|
|
|
2007-10-14 20:45:34 +02:00
|
|
|
|
- The IPTV section filtering code is derived from Linux kernel.
|