femon / rssreader / soppalusikka / iptv / satip / elvis / patches

SAT>IP plugin for VDR

Latest release


2018-04-15: Version 2.4.0

- Updated for vdr-2.4.0.
- Removed speed limit.
- Fixed transport media changes.
- Fixed memory leak in cSatipSectionFilter (Thanks to Alexander Pipelka).
- Added more robust section filter handling (Thanks to Alexander Pipelka).
- Added a command line parameter for the RTP receive buffer size (Thanks to Stefan Rehm).
Older versions can be found here.


This is an SAT>IP plugin for the Video Disk Recorder (VDR).

Written by:                  Rolf Ahrenberg

Project's homepage:          http://www.saunalahti.fi/~rahrenbe/vdr/satip/

Latest version available at: http://www.saunalahti.fi/~rahrenbe/vdr/satip/

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.
See the file COPYING for more information.


- Libcurl >= 7.36.0 - the multiprotocol file transfer library with RTSP support

- PugiXML - Light-weight, simple and fast XML parser for C++
  TinyXML - a simple, small, C++ XML parser

- Glibc >= 2.12 - the GNU C library (recvmmsg)


This plugin integrates SAT>IP network devices seamlessly into VDR.
You can use any SAT>IP 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.


tar -xzf /put/your/path/here/vdr-satip-X.Y.Z.tgz
make -C satip-X.Y.Z install


The plugin accepts a "--devices" (-d) command-line parameter defaulting
to two. This parameter defines how many simultaneous transponders can
be received, if there are available SAT>IP tuners.

The plugin accepts also a "--server" (-s) command-line parameter, that
can be used to manually configure static SAT>IP servers if autodetection
via UPnP somehow can't be used. The parameter string is a semicolon
separated list of "||" entries. The model
consists of a DVB system (DVBS2,DVBT2,DVBT,DVBC) and number of available
frontends separated by a hyphen:

vdr -P 'satip -s ||;...'
vdr -P 'satip -s|DVBS2-2,DVBT2-2|Octo1'
vdr -P 'satip -s|DVBS2-4|Octo1;|DVBT2-4|Octo2'

SAT>IP satellite positions (aka. signal sources) shall be defined via
sources.conf. If the source description begins with a number, it's used
as SAT>IP signal source selection parameter. A special number zero can
be used to disable the source. Otherwise, the default parameter is one:

S19.2E  Astra 1KR/1L/1M/2C
=> Signal source = 1

S19.2E  2
=> Signal source = 2

S19.2E  3 Astra 1KR/1L/1M/2C
=> Signal source = 3

S19.2E 0 Astra 1KR/1L/1M/2C
=> Source is disabled

A channel can be assigned into a specific SAT>IP frontend by giving the
identifier number in RID field of a channels.conf entry:
FE = RID % 100
Valid range: 1 ... 99

Setup menu:

- Operating mode = off       If you want exclude all SAT>IP devices
                   low       from VDR's device handling, set this
                   normal    option to "off". Otherwise, if you want
                   high      to keep SAT>IP at a low priority when
                             selecting available devices, set this
                             option to "low". Similarly, the "high"
                             value prefers the SAT>IP over the local
                             DVB cards when selecting available devices.
- Use CI extension = no      If you want to use the CI extension found
                             in some SAT>IP hardware (e.g. Digital
                             Devices OctopusNet), set this option to
- CICAM # =    If you want to assign a CA system into
                             a specific CI slot, set this option to
                             a named one. Use "---" for autoselection.
- Enable EPG scanning = yes  If you want exclude all SAT>IP devices
                             from VDR's EIT background scanning, set
                             this option to "no".
- Disabled sources = none    If your SAT>IP servers don't have certain
                             satellite positions available you can
                             disable them via this option.
- Disabled filters = none    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: "none" = 0 ... 7
- Transport mode = unicast   If you want to use the non-standard
                   multicast RTP-over-TCP transport mode, set this option
                   rtp-o-tcp accordingly. Otherwise, the transport
                             mode will be RTP-over-UDP via unicast or
- [Red:Scan]                 Forces network scanning of SAT>IP hardware.
- [Yellow:Devices]           Opens SAT>IP device status menu.
- [Blue:Info]                Opens SAT>IP information/statistics menu.
- [Ok]                       Opens information menu of selected SAT>IP

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.


- The stream id "-1" states about unsuccessful tuning. This might be a
  result of invalid channel parameters or lack of free SAT>IP tuners.

- If the plugin doesn't detect your SAT>IP network device, make sure
  your setup doesn't have firewalled the UDP port 1900.

- Stream decryption requires a separate CAM plugin that works without
  direct access to any DVB card devices. Also the integrated CAM slots
  in Octopus Net devices are supported.

- Tracing can be set on/off dynamically via command-line switch or
  SVDRP command.

- OctopusNet firmware 1.0.40 or greater recommended.

- Inverto OEM firmware or greater recommended.
  The firmware can be downloaded and installed
  from their webpage: http://www.inverto.tv/support/
  An update to a newer firmware should be offered afterwards.


- Big thanks to Digital Devices GmbH for providing the Octopus Net
  hardware for development!


screenshot screenshot screenshot screenshot