Metadata

Extra meta, catalog entry, video and manifest catalog fields AIOStreams reads, and what each one shows in a Jellyfin client.

These fields sit alongside the Stremio ones on a catalog entry, a meta, a video, or a catalog in your manifest. Put them on catalog entries too where you can: lists are built without opening each title.

Meta and catalog entry fields

Field	Shape	Shown in Jellyfin as
`ids`	object of provider ids	Provider ids and external links
`landscapePoster`	image URL	The wide card on Continue Watching, Next Up and home rows
`animatedPoster`	image URL, animated (GIF, animated WebP or APNG)	Played over the poster while its card is focused or hovered, in the AIOStreams apps
`originalTitle`	string	The original title, under the name when they differ
`tagline`	string	The tagline on the detail page
`people`	list of people	Cast and crew rows, with photos and characters
`certification`	string, e.g. `"PG-13"`	The age rating
`certificationLocal`	string, the rating in the viewer's country	The local rating, where a client shows one
`criticRating`	number, 0 to 100	The critic score
`ratings`	list of ratings	Each source's score, in the AIOStreams apps
`studios`	list of strings	Studios
`networks`	list of strings	Studios, after `studios`
`countries`	list of names or ISO 3166 codes	Production countries, by their English names
`tags`	list of strings	Tags
`endDate`	date, a series' last air date	The end of a series' year range
`airDays`	list of `"Sunday"` … `"Saturday"`	When a series airs
`airTime`	string, e.g. `"21:00"`	As above
`seasons`	list of seasons	Season names, overviews, posters and premiere dates
`collection`	collection block	A collection
`trailers`	list of trailers	The title's trailers, by name

People

{ "name": "Bryan Cranston", "role": "actor", "character": "Walter White", "photo": "https://…" }

Field	Meaning
`name`	Required.
`role`	Required. One of `actor`, `director`, `writer`, `producer`, `composer`, `creator`, `guestStar`; any other role is ignored.
`character`	Who an actor plays.
`photo`	A portrait URL.
`id`	The person's meta id.

Ratings

{ "source": "tomatoes", "value": 92, "scale": 100 }

Field	Meaning
`source`	Required. One of the sources below; any other is ignored.
`value`	Required. The score, from 0 up to `scale`.
`scale`	What `value` is out of. The source's own scale, below, when absent.

Source	What it is	Scale
`imdb`	IMDb rating	10
`tomatoes`	Rotten Tomatoes critics (Tomatometer)	100
`tomatoesAudience`	Rotten Tomatoes audience (Popcornmeter)	100
`metacritic`	Metascore	100
`letterboxd`	Letterboxd average	5
`rogerebert`	RogerEbert.com stars	4
`trakt`	Trakt rating	100
`tmdb`	TMDB user score	10
`mal`	MyAnimeList score	10

List them in the order to show them: where room is short, the apps show the first three. A source listed twice keeps its first entry. The IMDb score is also a title's community rating, and Rotten Tomatoes' its critic score, so other Jellyfin clients show those two; imdbRating and criticRating win where you send them. Episodes keep their own rating.

Trailers

Stremio's trailers, with a name added:

{ "source": "dQw4w9WgXcQ", "type": "Trailer", "name": "Official Trailer" }

Field	Meaning
`source`	Required. A YouTube video id, or a video's address.
`type`	Required. `Trailer` for a YouTube video, which Stremio plays too. Give a video's address another type, such as `Video`, so Stremio skips it.
`name`	What the trailer is called, such as `Teaser`. Shown as Trailer when absent.

trailerStreams, a list of stream objects that Stremio's apps read in place of trailers when a meta has both, is read too, for any trailer or name trailers doesn't have. Video addresses are listed before YouTube trailers.

Seasons

{ "season": 1, "name": "The Beginning", "overview": "…", "poster": "https://…", "released": "2019-03-01" }

season is required and matches the season of the videos it describes; 0 is specials. A season you do not list keeps its default name.

Video fields

These go on entries in a meta's videos.

Field	Shape	Shown in Jellyfin as
`rating`	number or numeric string, 0 to 10	The episode's rating
`ids`	object of provider ids	The episode's own ids and IMDb link
`people`	list of people	Guest stars and episode credits
`filler`	boolean	A filler mark in the web app
`recap`	boolean	A recap mark in the web app

A video's ids are the episode's own. A watch state event for an episode always carries the show's ids instead.

Catalog fields

These go on a catalog in your manifest's catalogs, which is a library in Jellyfin.

Field	Shape	Shown in Jellyfin as
`poster`	image URL	The library's tile
`background`	image URL	The library's backdrop

{ "type": "movie", "id": "netflix", "name": "Netflix", "poster": "https://…", "background": "https://…" }

Ids

ids is keyed by provider, with the same keys as watch state events. Values are strings; numbers are accepted.

Key	Provider	Key	Provider
`imdb`	IMDb	`kitsu`	Kitsu
`tmdb`	TMDB	`anidb`	AniDB
`tvdb`	TheTVDB	`simkl`	Simkl
`mal`	MyAnimeList	`trakt`	Trakt
`anilist`	AniList

Example

{
  "meta": {
    "id": "tt0903747",
    "type": "series",
    "name": "Breaking Bad",
    "landscapePoster": "https://…",
    "endDate": "2013-09-29",
    "tagline": "Remember my name",
    "ids": { "imdb": "tt0903747", "tmdb": "1396", "tvdb": "81189" },
    "certification": "TV-MA",
    "ratings": [
      { "source": "imdb", "value": 9.5, "scale": 10 },
      { "source": "tomatoes", "value": 96, "scale": 100 }
    ],
    "networks": ["AMC"],
    "countries": ["United States"],
    "airDays": ["Sunday"],
    "airTime": "22:00",
    "people": [
      { "name": "Vince Gilligan", "role": "creator" },
      { "name": "Bryan Cranston", "role": "actor", "character": "Walter White", "photo": "https://…" }
    ],
    "seasons": [{ "season": 1, "poster": "https://…", "released": "2008-01-20" }],
    "trailers": [{ "source": "…", "type": "Trailer", "name": "Official Trailer" }],
    "videos": [
      {
        "id": "tt0903747:1:1",
        "title": "Pilot",
        "season": 1,
        "episode": 1,
        "rating": 9.0,
        "ids": { "imdb": "tt0959621", "tvdb": "349232" }
      }
    ]
  }
}

Meta and catalog entry fieldsCopy Anchor Link

PeopleCopy Anchor Link

RatingsCopy Anchor Link

TrailersCopy Anchor Link

SeasonsCopy Anchor Link

Video fieldsCopy Anchor Link

Catalog fieldsCopy Anchor Link

IdsCopy Anchor Link

ExampleCopy Anchor Link

On this page