Used as a response for defineMetaHandler
id - required - string, universal identifier; you may use a prefix unique to your addon, for example yt_id:UCrDkAvwZum-UTjHmzDI2iIw
type - required - string, type of the content; e.g. movie, series, channel, tv (see Content Types)
name - required - string, name of the content
genres - optional - array of strings, genre/categories of the content; e.g. ["Thriller", "Horror"] (warning: this will soon be deprecated in favor of links)
poster - optional - string, URL to png of poster; accepted aspect ratios: 1:0.675 (IMDb poster type) or 1:1 (square) ; you can use any resolution, as long as the file size is below 100kb; below 50kb is recommended
posterShape - optional - string, can be square (1:1 aspect) or poster (1:0.675) or landscape (1:1.77). If you don’t pass this, poster is assumed
background - optional - string, the background shown on the stremio detail page ; heavily encouraged if you want your content to look good; URL to PNG, max file size 500kb
logo - optional - string, the logo shown on the stremio detail page ; encouraged if you want your content to look good; URL to PNG
description - optional - string, a few sentences describing your content
releaseInfo - optional - string, year the content came out ; if it’s series or channel, use a start and end years split by a tide - e.g. "2000-2014". If it’s still running, use a format like "2000-"
director, cast - optional - directors and cast, both arrays of names (string) (warning: this will soon be deprecated in favor of links)
imdbRating - optional - string, IMDb rating, a number from 0.0 to 10.0 ; use if applicable
released - optional - string, ISO 8601, initial release date; for movies, this is the cinema debut, e.g. “2010-12-06T05:00:00.000Z”
trailers - optional - array, containing objects in the form of { "source": "P6AaSMfXHbA", "type": "Trailer" }, where source is a YouTube Video ID and type can be either Trailer or Clip (warning: this will soon be deprecated in favor of meta.trailers being an array of Stream Objects)
links - optional - array of Meta Link objects, can be used to link to internal pages of Stremio, example usage: array of actor / genre / director links
videos - optional - array of Video objects, used for channel and series; if you do not provide this (e.g. for movie), Stremio assumes this meta item has one video, and it’s ID is equal to the meta item id
runtime - optional - string, human-readable expected runtime - e.g. “120m”
language - optional - string, spoken language
country - optional - string, official country of origin
awards - optional - string, human-readable that describes all the significant awards
website - optional - string, URL to official website
behaviorHints - all are optional - object, supports the properties:
defaultVideoId - string, set to a Video Object id in order to open the Detail page directly to that video’s streamsname - required - string, human readable name for the link
category - required - string, any unique category name, links are grouped based on their category, some recommended categories are: actor, director, writer, while the following categories are reserved and should not be used: imdb, share, similar
url - required - string, an external URL or Meta Link
id - required - string, ID of the video
title - required - string, title of the video
released - required - string, ISO 8601, publish date of the video; for episodes, this should be the initial air date, e.g. “2010-12-06T05:00:00.000Z”
thumbnail - optional - string, URL to png of the video thumbnail, in the video’s aspect ratio, max file size 5kb
streams - optional - array of Stream Objects, in case you can return links to streams while forming meta response, you can pass and array of Stream Objects to point the video to a HTTP URL, BitTorrent, YouTube or any other stremio-supported transport protocol; note that this is exclusive: passing video.streams means that Stremio will not request any streams from other addons for that video; if you return streams that way, it is still recommended to implement the streams resource
available - optional - boolean, set to true to explicitly state that this video is available for streaming, from your addon; no need to use this if you’ve passed streams
episode - optional - number, episode number, if applicable
season - optional - number, season number, if applicable
trailers - optional - array, containing Stream Objects
overview - optional - string, video overview/summary
{
id: "tt0108778:1:1",
title: "Pilot",
released: new Date("1994-09-22 20:00 UTC+02"),
season: 1,
episode: 1,
overview: "Monica and the gang introduce Rachel to the real world after she leaves her fiancé at the altar."
}
You can see a comprehensive example of how detailed Meta objects with videos are returned here, on the Cinemeta addon
{
id: "yt_id:UCrDkAvwZum-UTjHmzDI2iIw:9bZkp7q19f0",
title: "PSY - GANGNAM STYLE",
released: new Date("2012-07-15 20:00 UTC+02"),
thumbnail: "https://i.ytimg.com/vi/9bZkp7q19f0/hqdefault.jpg"
}
This is a shorter variant of the previously described Meta Object
Used as a response for defineCatalogHandler
id - required - string, universal identifier; you may use a prefix unique to your addon, for example yt_id:UCrDkAvwZum-UTjHmzDI2iIw
type - required - string, type of the content; e.g. movie, series, channel, tv (see Content Types)
name - required - string, name of the content
poster - required - string, URL to png of poster; accepted aspect ratios: 1:0.675 (IMDb poster type) or 1:1 (square); you can use any resolution, as long as the file size is below 100kb; below 50kb is recommended; also used as the background shown on the stremio discover page in the sidebar
posterShape - optional - string, can be square (1:1 aspect) or poster (1:0.675) or landscape (1:1.77). If you don’t pass this, poster is assumed
genres - optional - array of strings, genre/categories of the content; e.g. ["Thriller", "Horror"] (warning: this will soon be deprecated in favor of links)
imdbRating - optional - string, IMDb rating, a number from 0.0 to 10.0 ; use if applicable
releaseInfo - optional - string, year the content came out ; if it’s series or channel, use a start and end years split by a tide - e.g. "2000-2014". If it’s still running, use a format like "2000-"
director, cast - optional - directors and cast, both arrays of names (string) (warning: this will soon be deprecated in favor of links)
links - optional - array of Meta Link objects, can be used to link to internal pages of Stremio, example usage: array of actor / genre / director links
description - optional - string, a few sentances describing your content
trailers - optional - array, containing objects in the form of { "source": "P6AaSMfXHbA", "type": "Trailer" }, where source is a YouTube Video ID and type can be either Trailer or Clip (warning: this will soon be deprecated in favor of meta.trailers being an array of Stream Objects)