Difference between revisions of "IPTV"

From MythTV Official Wiki
Jump to: navigation, search
m (Link to TPG Australia howto)
(2 intermediate revisions by one user not shown)
Line 176: Line 176:
==Provider Specifics==
==Provider Specifics==
[[Sasktel IPTV]] <br>
[[Sasktel IPTV]] <br>
[[TransACT]] <br>
[http://tutori.alitility.com/doku.php?id=ubuntu:aontv_mythtv Aontv] <br>
[http://tutori.alitility.com/doku.php?id=ubuntu:aontv_mythtv Aontv] <br>
[http://avenard.com/iptv/MythTV.html TPG (Australia)]
[http://avenard.com/iptv/MythTV.html TPG (Australia)]

Revision as of 05:44, 12 August 2012

Wikipedia has an article on:

IPTV is a name for a collection of technologies used to stream Television over the Internet. Essentially, it's the protocols RTC/RTCP or RTSP for streaming the video & audio, and SAP/SDP to announce the streams, all operating over UDP multicast.

Differentiation and Support

Different live media transmission standards get called IPTV

  • DVB-IPTV (formerly DVB-IPI)
    • TV and radio can be recorded by the backend.
  • MPEG 2 SPTS over multicast (or almost DVB-IPTV. that's usually what your ISP serves you e.g. Freebox, MPEG2 TS Multicast on MBone)
    • TV and radio can be recorded by the backend.
  • stuff thats at least somewhat close to some MPEG standard (MPEG Codecs via HTTP etc., think Shoutcast Radios)
    • can not be recorded directly. Some can be remuxed by VideoLAN on demand into SPTS and fed into the backend.
  • any other media streaming via IP Networks (basically stuff that does not fit into a MPEG2 SPTS, like ShoutcastTV)
    • can not be recorded directly. Some can be transcoded by VideoLAN on demand into SPTS and fed into the backend.

Video (and Audio) on demand can be split similarly into

  • DVB/MPEG conformant services
  • Services that can be repackaged into DVB/MPEG (many podcasts)
  • Services that are completely different (many video hosting sites)
    • MythNews supports Youtube feeds.


Currently, there are a few implementations of SAP/SDP and RTP/RTCP that can be used to emulate being on an IPTV system. The most advanced version of this would be VideoLAN, which will take any kind of file it can open and will stream it over RTP/RTCP or RTSP (In version 8.3+), with automatic announcement over SAP/SDP.



SAP is a method of sending "Session Announcements" over UDP Multicast. SAP uses Multicast address port 9875 by default for sending announcements in the global scope.

A SAP announcement looks like this (Taken from the RFC):

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   | V=1 |A|R|T|E|C|   auth len    |         msg id hash           |
   |                                                               |
   :                originating source (32 or 128 bits)            :
   :                                                               :
   |                    optional authentication data               |
   :                              ....                             :
   |                      optional payload type                    |
   +                                         +-+- - - - - - - - - -+
   |                                         |0|                   |
   + - - - - - - - - - - - - - - - - - - - - +-+                   |
   |                                                               |
   :                            payload                            :
   |                                                               |

   V: Version Number. The version number field MUST be set to 1 (SAPv2
      announcements which use only SAPv1 features are backwards
      compatible, those which use new features can be detected by other
      means, so the SAP version number doesn't need to change).

   A: Address type. If the A bit is 0, the originating source field
      contains a 32-bit IPv4 address.  If the A bit is 1, the
      originating source contains a 128-bit IPv6 address.

   R: Reserved. SAP announcers MUST set this to 0, SAP listeners MUST
      ignore the contents of this field.

   T: Message Type. If the T field is set to 0 this is a session
      announcement packet, if 1 this is a session deletion packet.

   E: Encryption Bit. If the encryption bit is set to 1, the payload of
      the SAP packet is encrypted.  If this bit is 0 the packet is not
      encrypted.  See section 7 for details of the encryption process.

   C: Compressed bit. If the compressed bit is set to 1, the payload is
      compressed using the zlib compression algorithm [3].  If the
      payload is to be compressed and encrypted, the compression MUST be
      performed first.

   Authentication Length. An 8 bit unsigned quantity giving the number
      of 32 bit words following the main SAP header that contain
      authentication data.  If it is zero, no authentication header is

   Authentication data containing a digital signature of the packet,
      with length as specified by the authentication length header
      field.  See section 8 for details of the authentication process.

   Message Identifier Hash. A 16 bit quantity that, used in combination
      with the originating source, provides a globally unique identifier
      indicating the precise version of this announcement.  The choice
      of value for this field is not specified here, except that it MUST
      be unique for each session announced by a particular SAP announcer
      and it MUST be changed if the session description is modified (and
      a session deletion message SHOULD be sent for the old version of
      the session).

      Earlier versions of SAP used a value of zero to mean that the hash
      should be ignored and the payload should always be parsed.  This
      had the unfortunate side-effect that SAP announcers had to study
      the payload data to determine how many unique sessions were being
      advertised, making the calculation of the announcement interval
      more complex that necessary.  In order to decouple the session
      announcement process from the contents of those announcements, SAP
      announcers SHOULD NOT set the message identifier hash to zero.

      SAP listeners MAY silently discard messages if the message
      identifier hash is set to zero.

   Originating Source. This gives the IP address of the original source
      of the message.  This is an IPv4 address if the A field is set to
      zero, else it is an IPv6 address.  The address is stored in
      network byte order.

      SAPv0 permitted the originating source to be zero if the message
      identifier hash was also zero.  This practise is no longer legal,
      and SAP announcers SHOULD NOT set the originating source to zero.
      SAP listeners MAY silently discard packets with the originating
      source set to zero.

The standard announcement type for SAP is SDP.


An SDP announcement looks like this:

v= (protocol version)
o= (owner/creator and session identifier).
s= (session name)
i=* (session information)
u=* (URI of description)
e=* (email address)
p=* (phone number)
c=* (connection information - not required if included in all media)
b=* (bandwidth information)

One or more time descriptions (see below)

z=* (time zone adjustments)
k=* (encryption key)
a=* (zero or more session attribute lines)

Zero or more media descriptions (see below)

Time description
t= (time the session is active)
r=* (zero or more repeat times)

Media description
m= (media name and transport address)
i=* (media title)
c=* (connection information - optional if included at session-level)
b=* (bandwidth information)
k=* (encryption key)
a=* (zero or more media attribute lines)


o=mhandley 2890844526 2890842807 IN IP4
s=SDP Seminar
i=A Seminar on the session description protocol
e=mjh@isi.edu (Mark Handley)
c=IN IP4
t=2873397496 2873404696
m=audio 49170 RTP/AVP 0
m=video 51372 RTP/AVP 31
m=application 32416 udp wb

For more information, please see the RFC





Important.png Note: The FreeBox patch that's in #1704 uses RTSP to receive IPTV streams from an ADSL box. However, this version uses a PLS "Playlist" provided by the box to discover channels, not SDP/SAP, thereby still needing a STB to tune. If we can make a version that uses SDP/SAP Discovery, this requirement will not be needed, and the "Tuner" can be made into a more generic "IPTV tuner".

Provider Specifics

Sasktel IPTV
TPG (Australia)