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.
image	No	A URL to an image for this program.
date	No	The original air date for this program.

Example

{
  "version": 1,
  "epg": {
    "een.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"
      }
    ],
    "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"
      }
    ]
  }
}