Used as a response for defineStreamHandler
One of the following must be passed to point to the stream itself
url - string, direct http(s)/ftp(s)/rtmp link to a video stream (protocol support can vary depending on client app capabilities)ytId - string, youtube video ID, plays using the built-in YouTube playerinfoHash - string, info hash of a torrent file, and fileIdx is the index of the video file within the torrent; if fileIdx is not specified, the largest file in the torrent will be selectedfileIdx - number, the index of the video file within the torrent (from infoHash), nzb (from nzbUrl), rar (from rarUrls, zip (from zipUrls), 7zip (from 7zipUrls), tgz (from tgzUrls), tar (from tarUrls)); (for torrents if fileIdx is not specified, the largest file will be selected)fileMustInclude - string, a string representing a regex (example "/.mkv$|.mp4$|.avi$|.ts$/i") to match the video file within the nzb (from nzbUrl), rar (from rarUrls, zip (from zipUrls), 7zip (from 7zipUrls), tgz (from tgzUrls), tar (from tarUrls)); (not supported for torrents yet)nzbUrl - string, http(s) or ftp(s) link to a NZB (usenet) file (this source will also unpack any known archive files), also see: Source Limitationsservers - array, a list of strings that each represent a connection to a NNTP (usenet) server (for nzbUrl) in the form of nntp(s)://{user}:{pass}@{nntpDomain}:{nntpPort}/{nntpConnections} (nntps = SSL; nntp = no encryption) (example: nntps://myuser:mypass@news.example.com:563/4)rarUrls - array, a list of Source Objects that lead to rar files (multi-volume supported), also see: Source LimitationszipUrls - array, a list of Source Objects that lead to zip files (multi-volume supported), also see: Source Limitations7zipUrls - array, a list of Source Objects that lead to 7z files (multi-volume supported), also see: Source LimitationstgzUrls - array, a list of Source Objects that lead to tgz files (multi-volume supported), also see: Source LimitationstarUrls - array, a list of Source Objects that lead to tar files (TAR does not support multi-volume), also see: Source LimitationsexternalUrl - string, Meta Link or an external URL to the video, which should be opened in a browser (webpage), e.g. link to Netflixname - optional - string, name of the stream; usually used for stream quality
title - optional - string, description of the stream (warning: this will soon be deprecated in favor of stream.description)
description - optional - string, description of the stream (previously stream.title)
subtitles - optional - array of Subtitle objects representing subtitles for this stream
sources - optional - array of strings, represents a list of torrent tracker URLs and DHT network nodes. This attribute can be used to provide additional peer discovery options when infoHash is also specified, but it is not required. If used, each element can be a tracker URL (tracker:<protocol>://<host>:<port>) where <protocol> can be either http or udp. A DHT node (dht:<node_id/info_hash>) can also be included.
WARNING: Use of DHT may be prohibited by some private trackers as it exposes torrent activity to a broader network, potentially finding more peers.
behaviorHints (all are optional)
countryWhitelist: which hints it’s restricted to particular countries - array of ISO 3166-1 alpha-3 country codes in lowercase in which the stream is accessiblenotWebReady: applies if the protocol of the url is http(s); needs to be set to true if the URL does not support https or is not an MP4 filebingeGroup: if defined, addons with the same behaviorHints.bingeGroup will be chosen automatically for binge watching; this should be something that identifies the stream’s nature within your addon: for example, if your addon is called “gobsAddon”, and the stream is 720p, the bingeGroup should be “gobsAddon-720p”; if the next episode has a stream with the same bingeGroup, stremio should select that stream implicitlyproxyHeaders: only applies to urls; When using this property, you must also set stream.behaviorHints.notWebReady: true; This is an object containing request and response which include the headers that should be used for the stream (example value: { "request": { "User-Agent": "Stremio" } })videoHash: - string, the calculated OpenSubtitles hash of the video, this will be used when the streaming server is not connected (so the hash cannot be calculated locally), this value is passed to subtitle addons to identify correct subtitlesvideoSize: - number, size of the video file in bytes, this value is passed to the subtitle addons to identify correct subtitlesfilename: - string, filename of the video file, although optional, it is highly recommended to set it when using stream.url (when possible) in order to identify correct subtitles (addon sdk will show a warning if it is not set in this case), this value is passed to the subtitle addons to identify correct subtitlesAn object representing a streaming source, supports the following properties:
url - required - string, direct http(s)/ftp(s) link to a file (depending on context: zip, rar, 7z, tar, tgz)bytes - optional - integer, size of the file in bytes - while optional adding this can speed up the initial buffering