dvbipitools

Tools for handling DVB-IPI streams.

They kept piling up in private VCS over many years, so I finally decided to polish, consolidate, and publish them. GitHub is not the primary development repository, but releases are published here and pull requests are welcome.

AI helped with the README files, -h boilerplate, man pages and test scaffolding they never had before. I did not let it mess up the hard parts.

Fantastic tools and where to deploy them

Tool	Contrib	Headend	Edge	Client	Lab	Purpose
dipitvhead	✔️	✔️			✔️	IPTV SCS/Muxer/Scrambler
dipiradiohead	✔️	✔️			✔️	Radio SCS/Muxer/Scrambler
dipirist	✔️	✔️			✔️	RTP/TS RIST bridge
dipisrt	✔️	✔️			✔️	RTP/TS SRT bridge
dipimetrics	✔️	✔️	✔️		✔️	Per-host OpenMetrics
dipifccret		✔️	✔️		✔️	FCC (Annex I), RET (Annex F) server
dipisds		✔️		✔️	✔️	DVBSTP/SD&S (announce & listen)
dipibcg		✔️		✔️	✔️	DVBSTP/TVA BCG (publisher & reader)
dipixmltv		✔️		✔️	✔️	XMLTV <-> DVB-IPI TVA XML converter
dipirec				✔️	✔️	record and replay (FCC/RET client)
dipiscan				✔️	✔️	Multicast TV/radio scanner (w/o SD&S)
dipibim					✔️	TVA XML BiM enc/dec (debug dipibcg)
dipicam378					✔️	cs378x CAS test CAM
dipidescramble					✔️	CAS validation descrambler
dvbipitools	✔️	✔️	✔️	✔️	✔️	All of the above (multicall)

Build

Your choice. Go for the classics: ./configure --release && make -j"$(nproc)" or use CMake:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Options

CMake	configure
-DCMAKE_BUILD_TYPE=Debug|Release	--debug / --release	Build type
-DDVBIPITOOLS_STATIC=ON	--static	Static linking
-DDIPIRADIOHEAD_TLS=OFF / -DDIPITVHEAD_TLS=OFF / -DDIPIREC_TLS=OFF	--no-tls	Build the respective tool without TLS source support
-DDIPITVHEAD_CSA=OFF / -DDIPIRADIOHEAD_CSA=OFF / -DDIPIDESCRAMBLE_CSA=OFF	--no-csa	Build the respective tool without CSA1/CSA2/BISS1
-DDIPIBCG_ZLIB=OFF	--no-zlib	Build dipibcg without BCG container compression support
-DDVBIPITOOLS_RIST=OFF	--no-rist	Skip librist detection, disable dipirist/rist:// support
-DDVBIPITOOLS_SRT=OFF	--no-srt	Skip libsrt detection, disable dipisrt

Note: The build automatically disables TLS support if OpenSSL is not found.

Dependencies

• libssl
  • Required for HTTPS sources in dipitvhead and dipiradiohead.
  • Enables CISSA/AES-128 Conditional Access, and BISS2 (Mode 1/E Session Word AES-128, Mode CA RSA-OAEP receiver keys) in dipitvhead and dipiradiohead.
  • Required to build dipicam378/dipidescramble at all - RSA/AES crypto is their whole purpose, so both are skipped entirely if not found.
• zlib
  • Optional: -Z/--compress in dipibcg (zlib/RFC 1950 compression of BCG containers)
• libdvbcsa
  • Not a build dependency: If present, dipitvhead, dipiradiohead and dipidescramble can use it to enable CSA1/CSA2/BISS1 support.
• librist
  • Required to build dipirist at all.
  • Optional: adds RIST support to dipitvhead, dipiradiohead and dipirec.
• libsrt
  • Required to build dipisrt at all.

Packaging

dpkg-buildpackage -b -us -uc

Build-Depends: debhelper-compat (= 13), cmake, libssl-dev, librist-dev.

Editorial notes

Some of the implemented formats are not part of DVB-IPI. They exist for convenience and to bridge between real-world usage of media formats and the standard.

Notable additions

• dipitvhead
  • HbbTV AIT injection (--hbbtv, ETSI TS 102 809) is hybrid broadcast/broadband signaling, a separate spec.
  • MPTS support is more like an interpretation than "specs driven". ETSI TS 102 034 v2.1.1 mentions Multi Program Transport Streams (MPTS) exactly twice:
    • In the abbreviation list
    • According to §7.1.0, Content Service Providers can use them
  • BISS (EBU Tech 3292): BISS1 Mode 1 (CSA1), BISS2 Mode 1/E (CISSA) and BISS2 Mode CA (RSA-OAEP receiver entitlement). DVB-IPI prioritizes SimulCrypt.
• dipiradiohead
  • Icecast/Shoutcast as an input source - none of this is part of DVB.
  • ICY StreamTitle, inline ID3v2 TIT2/TPE1 mapping into EIT.
• dipirec
  • Matroska containers (mkv and mka).
  • SubRip subtitles (.srt) from EBU Teletext (ETSI EN 300 706). SRT isn't a DVB format.
• dipiscan
  • This tool would largely be unnecessary if deployments consistently used DVBSTP/SD&S as implemented by dipisds.
  • m3u, xspf and our own "local" csv format.
• dipisds
  • All supported formats other than SD&S XML/BiM are convenience additions.
• dipixmltv
  • XMLTV is not part of DVB-IPI; TVA XML encoded as BiM is.
  • CRIDs using the authority dipixmltv.invalid, reserved under RFC 2606 because this project is not a registered CRID authority.
• dipibim
  • An uncompressed representation of TVA EPG data is not specified by ETSI TS 102 539, §7.2.
• dipimetrics
  • OpenMetrics is not part of any DVB/ETSI specification.
• dipirist
  • Reliable Internet Stream Transport (RIST) is not part of DVB.
• dipisrt
  • Secure Reliable Transport (SRT) is not part of DVB.

Known gaps

On the other hand, full DVB-IPI goes way beyond the scope of this toolkit.

• FEC (Annex E)
• Companion Stream FCC (Annex J). RAMS-based FCC is provided by dipifccret
• DVB Companion Screens and Streams
• DVB Home Network, ETSI TS 102 905
• SD&S record type "CoD Discovery" and "Services From Other SPs"
• RTSP command/control for CoD services and multicast join (§6)
• DHCP-based IP address assignment for the HNED (§8)
• FUSS, the mandatory File Upload System Stub (§9)
• Content Download Services / CDS, push or pull (§10)
• Full QoS/DiffServ behavior (§11): Only limited or fixed DSCP handling is implemented
• SRM delivery for Content Protection revocation (§12)
• Dynamic Service Management (§13)

Indirectly related:

• dipitvhead, dipiradiohead and dipidescramble:
  • no support for ETSI TS 103 197 CSA3 or non-standard CSA2 modes
  • no BISS1 Mode E
  • no BISS-CA group keys, only device keys
  • no eECMs

Licence

GPL-3.0-or-later. See LICENSE and NOTICE.