vdr-plugin-iptv/README

This is a IPTV 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<70>l<EFBFBD>,
                             a j h s e p p a @ n i k s u l a . h u t . f i

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 as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
See the file COPYING for more information.

Requirements:

An IPTV patched VDR-1.5.9 (or later) setup and multicast/unicast MPEG-2
transport 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, ...

Currently the IPTV plugin supports multicast UDP/RTP and unicast HTTP
MPEG-2 transport streams. Also a file input method is supported, but
file delay must be selected individually to prevent VDR's transfer
buffer over/underflow. Therefore it should be considered as a testing
feature only.

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
patch -p1 < PLUGINS/src/iptv/patches/vdr-1.5.x-closefilter.patch
patch -p1 < PLUGINS/src/iptv/patches/vdr-1.5.x-pluginparam.patch
cp sources.conf /path/to/vdrconf/
make
make plugins
./vdr -P iptv

Setup menu:

- TS buffer size [MB] = 2          Defines ringbuffer size for transport
                                   stream in MB.
                                   The valid range: 1...4
- 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.
                                   The valid range: 0...1
- Scan Sid automatically = 1       Defines whether service id shall be
                                   scanned automatically. Requires section
                                   filtering.
                                   The valid range: 0...1
- Disable filters = 0              Certain section filters might have some
                                   unwanted behaviour. This option allows you
                                   to blacklist them. 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.
                                   The valid range: 0...7
- [Red:Channels]                   Opens IPTV channel editor.
- [Blue:Info]                      Opens IPTV information/statistics menu.

Channel editor menu:

- Read VDR's MANUAL for detailed information.

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

  TV3;IPTV:3:IPTV|FILE|/media/video.ts|5:P:0:514:670:2321:0:3:0:0:0
  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")
           | |    |   |         IP Port Number or File delay (ms)
           | |    |   IP Address or File Location
           | |    Protocol ("UDP", "HTTP", "FILE")
           | Plugin ID ("IPTV")
           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

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)"