How stremio/stremio-addon-sdk works
This SDK turns an addon manifest and resource handlers into an HTTP protocol service: addon authors register catalog, metadata, stream, subtitle, or addon-catalog behavior; Stremio calls the resulting endpoints and receives JSON responses. It also provides an install/configuration landing page, Express-router embedding, and optional publishing to Stremio’s central collection. The runtime is small, so the graph focuses on those product capabilities. Relationships are grounded in the README and sampled sources; addon-specific data sources are described by the README but are outside this repository.
Main entry points: builder.js Addon interface · getRouter.js Protocol router · serveHTTP.js HTTP server · publishToCentral.js Central publisher
Components 16
Addon Definition
- Manifest and handlers
src/builder.js - Catalog handlers
src/builder.js - Metadata handlers
src/builder.js - Stream handlers
src/builder.js - Subtitle handlers
src/builder.js - Addon catalog handlers
src/builder.js - Addon interface
src/builder.js
HTTP Serving
- Protocol router
src/getRouter.js - HTTP server
src/serveHTTP.js - Install/config page
src/landingTemplate.js
Install and Publish
- Central publisher
src/publishToCentral.js
Other components
- Stremio app
- Addon author
- Express host
- Addon data sources
- Public addon collection
Connections 26
- Addon author → Manifest and handlers: defines manifest
README.md - Manifest and handlers → Addon interface: builds interface
src/builder.js - Addon author → Catalog handlers: registers handler
README.md - Addon author → Metadata handlers: registers handler
README.md - Addon author → Stream handlers: registers handler
README.md - Addon author → Subtitle handlers: registers handler
README.md - Addon author → Addon catalog handlers: registers handler
README.md - Addon interface → Catalog handlers: dispatches requests
src/builder.js - Addon interface → Metadata handlers: dispatches requests
src/builder.js - Addon interface → Stream handlers: dispatches requests
src/builder.js - Addon interface → Subtitle handlers: dispatches requests
src/builder.js - Addon interface → Addon catalog handlers: dispatches requests
src/builder.js - Addon author → HTTP server: starts service
README.md - HTTP server → Protocol router: mounts router
src/serveHTTP.js - HTTP server → Install/config page: renders page
src/serveHTTP.js - Addon author → Protocol router: mounts in Express
README.md - Express host → Protocol router: hosts router
README.md - Protocol router → Addon interface: calls get
src/getRouter.js - Protocol router → Stremio app: returns protocol JSON
README.md - Stremio app → HTTP server: requests resources
README.md - Catalog handlers → Addon data sources: queries sources
- Metadata handlers → Addon data sources: queries sources
- Stream handlers → Addon data sources: queries sources
- Subtitle handlers → Addon data sources: queries sources
- Addon author → Central publisher: publishes URL
README.md - Central publisher → Public addon collection: submits addon
src/publishToCentral.js