1
0
mirror of https://github.com/rofafor/vdr-plugin-iptv.git synced 2023-10-10 13:37:03 +02:00
vdr-plugin-iptv/README

129 lines
5.2 KiB
Plaintext
Raw Normal View History

2007-09-12 19:28:59 +02:00
This is a IPTV for the Video Disk Recorder (VDR).
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
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
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
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
cp sources.conf /path/to/vdrconf/
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.
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.
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.
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
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.
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
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
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
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)"
Acknowledgements:
2007-10-14 20:45:34 +02:00
- The IPTV section filtering code is derived from Linux kernel.