mirror of
https://github.com/rofafor/vdr-plugin-iptv.git
synced 2023-10-10 13:37:03 +02:00
129 lines
5.2 KiB
Plaintext
129 lines
5.2 KiB
Plaintext
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älä
|
|
<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 DVB compatible MPEG1/2
|
|
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 supports 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 file input 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.
|
|
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.
|
|
Valid range: 0...1
|
|
- Scan Sid automatically = 1 Defines whether service id shall be
|
|
scanned automatically. Requires section
|
|
filtering.
|
|
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
|
|
- [Red:Channels] Opens IPTV channel editor.
|
|
- [Blue:Info] Opens IPTV information/statistics menu.
|
|
|
|
Channel editor menu:
|
|
|
|
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.
|
|
IPTV channel editor is accessible via Setup -> Plugins -> IPTV and pressing
|
|
Red button. The channel editor is functionally similar to VDR's built-in
|
|
channel editor.
|
|
|
|
- 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)"
|