JSON EPG format

The JSON-EPG format is an alternative format for the XMLTV format (as used by Kodi's PVR IPTV Simple add-on) to list TV and Radio channel EPG data with all required metadata.

JSON-EPG format

This is a draft for version 1 of the standard.

The key used in the epg dictionary should be the same as the id of the channel in the JSON-STREAMS format. This will be used to link the data to the right channel.

Attributes

Attribute	Required	Description
start	Yes	The start time of the program in YYYY-MM-DDTHH:MM:SS format.
stop	Yes	The end time of the program in YYYY-MM-DDTHH:MM:SS format.
title	Yes	The title of the program.
description	No	The description of the program.
subtitle	No	The subtitle of the program. This can be the Episode name.
episode	No	The episode number in case of a show in the S01E01 format.
genre	No	The genre of this program.
image	No	A URL to an image for this program.
date	No	The original air date for this program.
stream	No	An direct plugin://-url to play this program.

More information

• stream
  This is the endpoint that will be called when this program should play. It will be used to directly play a program from the EPG, without generating an URI based on the timestamp using the vod-attribute from the JSON-STREAMS. If no stream is available, the vod attribute can still be used to try to play the program.

  Example: plugin://plugin.video.example/play/catalog/f71549ba-f985-41c3-916a-6cc3b3305b83

Example

{
  "version": 1,
  "epg": {
    "een.be": [
      {
        "start": "2020-04-01T12:45:00",
        "stop": "2020-04-01T12:50:00",
        "title": "My Show",
        "genre": "Quiz",
        "description": "Description of My Show",
        "subtitle": "Episode name for My Show",
        "episode": "S01E05",
        "image": "https://www.example.com/shows/my-show/s01e05.png",
        "date": "2018-04-01",
        "stream": "plugin://plugin.video.example/play/catalog/3F2504E0-4F89-11D3-9A0C-0305E82C3301"
      }
    ],
    "radio1.be": [
      {
        "start": "2020-04-01T12:45:00",
        "stop": "2020-04-01T12:50:00",
        "title": "My Show",
        "description": "Description of My Show",
        "subtitle": "Episode name for My Show",
        "episode": "S01E05",
        "image": "https://www.example.com/shows/my-show/s01e05.png",
        "date": "2018-04-01"
      }
    ]
  }
}