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

183 lines
8.1 KiB
Plaintext
Raw Normal View History

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
Antti Seppälä
< a . s e p p a l a @ g m a i l . c o m >
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:
An IPTV patched VDR setup and DVB compatible MPEG1/2 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-20 20:26:38 +02:00
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.
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-27 14:55:04 +02:00
patch -p1 < PLUGINS/src/iptv/patches/vdr-X.Y.Z-pluginparam.patch
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.
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.
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
2007-10-07 17:56:52 +02:00
- Use section filtering = 1 Defines whether section filtering shall
be used.
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
- Scan Sid: [yes|no] Defines whether service id shall be
scanned automatically. Service id is
used in channel identification and
EPG information is set according to it.
This option requires section filtering.
- Scan pids: [yes|no] Defines whether video and audio pids
shall be scanned automatically. This
option is useful with streams missing
correct PAT/PMT information.
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
TV4;IPTV:40:IPTV|S1P0|EXT|iptvstream.sh|0:P:0:0:680:0:0:4:0:0:0
TV3;IPTV:30:IPTV|S0P1|FILE|/video/stream.ts|5:P:0:514:670:2321:0:3:0:0:0
TV2;IPTV:20:IPTV|S0P1|HTTP|127.0.0.1/TS/2|3000:P:0:513:660:2321:0:2:0:0:0
TV1;IPTV:10:IPTV|S1P0|UDP|127.0.0.1|1234:P:0:512:650:2321:0:1:0:0:0
^ ^ ^ ^ ^ ^ ^
| | | | | | Source type ("P")
| | | | | IP Port Number, File delay (ms), Script parameter
| | | | IP Address, File location, Script location
| | | Protocol ("UDP", "HTTP", "FILE", "EXT")
| | Parameters ("S" Sid scan, "P" Pid scan, "0" disable, "1" enable)
| Plugin ID ("IPTV")
2007-10-07 17:56:52 +02:00
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
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.
2007-10-20 19:48:49 +02:00
- 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. The
plugin was tested with VLC version 0.8.6c.
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.
2009-03-31 07:17:24 +02:00
- 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:
2007-10-14 20:45:34 +02:00
- The IPTV section filtering code is derived from Linux kernel.
- The pid scanning code is derived from Udo Richter's streamplayer plugin.