Skip to content

Adding the EPG to MPTS

This page describes how to add the EPG to output MPTS streams.

Flussonic can generate MPTS streams with an embedded electronic program guide (EPG). You no longer need to use an additional EPG generator and remultiplexer to add EPG to TV channels.

Flussonic takes the EPG from files in the XMLTV format and converts it into EIT (service information tables) of the output transport stream. The EIT is included into the transport stream both for the current multiplexer (Actual) and for other multiplexers in a network (Other). The EPG is packed into the target bitrate, and a stream with a ready-made schedule goes to UDP multicast.

The description of the file format can be found at xmltv.org, and the broadcast schedule in this format is available at teleguide.info.

How to import EPG to a multiplexer:

  1. In the multiplexer settings, add EIT options.

  2. Each time the data in the XMLTV file is updated, you must reload the file into the multiplexer with the dedicated API command.

  3. If you store the version number in a separate file, each time the data in the XMLTV file is updated, you may need to update the version number in the file.

Configuring the multiplexer to include the EPG

Consider the following configuration:


transponder tp1 {
  program 100 { 
    title "program1"; 
    eit_title "example_title"; 
  };
  other @tp2;
  eit { 
        xmltv_url xmltv_dir1; 
        interval pf actual=1 other=2;
        interval schedule other=20;
  }
}

where:

  • title — sets the channel ID value from the channel id in the XMLTV file.

  • eit_title — sets the channel name. To associate the TV program from the XMLTV file with the MPTS, specify the value of the display-name from XMLTV in the eit_title.

  • xmltv_url — sets the path to the directory with XMLTV files. It can be a single file name, for example, xmltv_url /path/to/xmltv.xml.

  • interval pf|schedule actual=<INTERVAL 1> other=<INTERVAL 2> — sets how often the EIT tables will be sent. The EPG is transmitted in two tables: the present/following program (pf) in one table and the schedule for several days (schedule) in the other table.

    • pf — how often the EIT table for the present/following program will be sent, in seconds.
    • schedule — how often the EIT table for the schedule will be sent, in seconds.
    • actual — defines the interval for the EPG transmitted in the multiplexer that you edit (tp1 in the example).
    • other — defines the interval for the EPG transmitted in the multiplexer (tp2 in the example) that was specified in the other option.

    If you set interval to 0, the EIT table will not be transferred.

    By default, actual (present/following) is 2 seconds, other (present/following) is 4 seconds, actual (schedule) and other (schedule) are 60 seconds.

    Note: To transfer a large amount of EPG data without cutting out any of it, you can try increasing the interval and/or decreasing the number of programs.

Reloading the EPG into the multiplexer

When the EPG data has been updated in the XMLTV file, it must be passed to the multiplexer.

To make Flussonic reload the updated XMLTV data from the xmltv_url directory, run the API call POST /streamer/api/v3/multiplexers/{name}/xmltv_upload

For our example this call looks like:

/streamer/api/v3/multiplexers/tp1/xmltv_upload

EIT version

When the schedule is updated, the EIT version changes. The version is a number from 0 to 63.

Notes

The XMLTV file from teleguide.info might contain overlapping transmissions. If this occurs, then Flussonic includes the earlier transmission to the EPG, and excludes the later one.