Build carrier-grade IPTV infrastructure. Or just pretend you do in your lab.

Although DVB-IPI (ETSI TS 102 034) provides the conceptual backbone for the toolkit, individual services are intentionally decoupled. You don’t need a complete DVB-IPI environment to benefit from them. Daemons like dipitvhead or dipiradiohead work just as well feeding an RF modulator, acting as stream processors, or powering custom video distribution setups.

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. I did not let it mess up the hard parts.

HN: Home Network, not directly on client devices.

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

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

• libssl
  • Required for HTTPS sources in dipitvhead, dipiradiohead, dipixy, dipirist, dipisrt and dipirec.
  • Enables CISSA/AES-128 Conditional Access, and BISS1E / 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.
  • Required for dipimetrics and dipixy to serve HTTPS.
• zlib
  • Optional: -Z/--compress in dipibcg (zlib/RFC 1950 compression of BCG containers)
  • Optional: dipiradiohead decodes compressed ID3v2.3 frames (ICY/HLS timed metadata)
• 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, dipirec, dipixy and dipidescramble
• libsrt
  • Required to build dipisrt at all.
  • Optional: adds SRT support to dipitvhead, dipiradiohead, dipirec, dipixy and dipidescramble
• libnghttp2, libngtcp2 (>= 1.22), libngtcp2_crypto_ossl and libnghttp3
  • HTTP/2 and HTTP/3 support in dipixy.

dpkg-buildpackage -b -us -uc

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

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.

Note: Some of the mentioned formats or protocols are supported across the toolchain. To keep it short, they get only mentioned once: at their most relevant/affected tool.

• 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/E (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-IPI.
  • 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). SubRip 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.
• dipixy
  • HLS, LL-HLS, MPEG-DASH and LL-DASH output are not part of DVB-IPI.
  • MPEG-5 LCEVC is too young for DVB-IPI, but just fits.

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

• The implemented AL-FEC is Annex E Layer 1, not Layer 2 (Raptor RFC 5053)
• FCC in dipifccret is Annex I (RFC 6285 RAMS), not an Annex J Companion Stream
• DVB Companion Screens and Streams
• 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)
• SRM delivery for Content Protection revocation (§12)
• Dynamic Service Management (§13)

Indirectly related:

• dipitvhead, dipiradiohead and dipidescramble:
  • no ETSI TS 103 197 CSA3 or non-standard CSA2 "alternative" modes
  • no eECMs

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