Find file Copy path
7a98c8a Jan 17, 2019
2 contributors

Users who have contributed to this file

@Ivshti @jaruba
executable file 118 lines (73 sloc) 4.55 KB

Stremio Add-on SDK


Stremio Add-on SDK was developed by the Stremio Team as a way of vastly simplifying Node.js add-on creation for our streaming platform.

Stremio currently supports Windows, OSX, Linux, Android and iOS.

Quick Example

This arbitrary example creates an add-on that provides a stream for Big Buck Bunny and outputs a HTTP address where you can access it.

const addonSDK = require('stremio-addon-sdk')

const addon = new addonSDK({
    id: 'org.myexampleaddon',
    version: '1.0.0',

    name: 'simple example',

    // Properties that determine when Stremio picks this add-on
    // this means your add-on will be used for streams of the type movie
    resources: ['stream'],
    types: ['movie'],
    idPrefixes: ['tt']

// takes function(args, cb)
addon.defineStreamHandler(function(args, cb) {
    if (args.type === 'movie' && === 'tt1254207') {
        // serve one stream to big buck bunny
        // return addonSDK.Stream({ url: '...' })
        const stream = { url: '' }
        cb(null, { streams: [stream] })
    } else {
        // otherwise return no streams
        cb(null, { streams: [] })

addon.runHTTPWithOptions({ port: 7000 })
//addon.publishToCentral("https://your-domain/manifest.json") // <- invoke this if you want to publish your add-on and it's accessible publically on "your-domain"

Save this as addon.js and run:

$ npm install stremio-addon-sdk
$ node ./addon.js

It will output a URL that you can use to install the add-on in Stremio


All our documentation is hosted on GitHub. Take a look at our examples list for some high-level information, or dive straight into our sdk documentation for our code reference docs.

We also have an example add-on that you can use as a guide to help you build your own add-on.

If you don't wish to use Node.js (and therefore not use this SDK either), you can create add-ons in any programming language, see the add-on protocol specification for more information.

It is also possible to create an add-on without any programming language, see our static add-on example based on the protocol specification.

SDK Features Include:


For developers looking for a quick way to test their new add-ons, you can either:


In order for your add-on to be used by others, it needs to be hosted online.

You can check our list of recommended hosting providers for Node.js or alternatively host it locally with localtunnel.


Check out our ever growing list of examples and demo add-ons.

Reporting Issues

If you have any issues regarding the Stremio Add-on SDK, please feel free to report them here.

Use Cases Outside Add-on SDK

The use of this SDK is not mandatory for creating Stremio Add-ons. You can use any programming language that supports creating a HTTP server to make Stremio Add-ons. Refer to our protocol specification for details and examples.

One useful scenario of not using the SDK is when you need user specific data for you add-on (for example, an API Autherntication Token), you can see an example of passing user specific data in the Add-on Repository URL here. This example uses Node.js and Express to get user specific data.

built with love and serious coding skills by the Stremio Team