An extensible media platform for OTT devices.

Usage no npm install needed!

<script type="module">
  import oddnetworksOddworks from 'https://cdn.skypack.dev/@oddnetworks/oddworks';



pipeline status Dependency Status

Oddworks is an open source video distribution platform built to destroy the barriers to streaming television. Use it to:

  • Deliver your video content to TV connected platforms like Apple TV and Roku.
  • Proxy, cache, and bend the space time continuum between your content management system and existing online video platform (Vimeo, YouTube, Ooyala, Brightcove).
  • Aggregate usage metrics from your video apps to expand viewership and create custom viewing experiences.
  • Distribute content from multiple sources out to your social channels.

Become your own video distribution channel!

Table of contents


Oddworks is made up of several loosely coupled services. All of these services are automatically installed as dependencies when you install Oddworks. Oddworks uses NPM for dependency and package management (see Technology below).


The content server is also database agnostic in which you can store your entities in whatever database engine you like or a combination of any.

Currently Oddworks has support for the following:

  • memory (best used for development and testing)
  • redis
  • redis-search (a full text search implementation based on the N-gram algorithm)
  • DynamoDB

The implementation of these can be found in the ./lib/stores directory.


  • catalog (responsible for views, collections, and videos)
  • identity (responsible for channels, platforms, viewers, authentication, and entitlements)
  • server (a Node.js HTTP server)

The implementation of these can be found in the ./lib/services directory.


The available middleware is used when setting up an Express.js HTTP server.

The implementation of these can be found in the ./lib/middleware directory.


The Oddworks Platform consists of two main concepts:

  1. The Oddworks Content Server which maintains a database of your content and provides it to your apps via a strictly specified JSON API.
  2. The Oddworks platform SDKs which are designed to consume the content from the Oddworks Content Server as well as report usage data back to it.

Using oddworks


> npm install @oddnetworks/oddworks

In your server script:

const oddworks = require('@oddnetworks/oddworks');


The Oddworks CLI is also available

> npm install -g @oddnetworks/oddworks-cli

Example Content Server Implementations

Current example content server implementations can be found (with their instructions) here:

platform SDKs

In addition to the SDKs there are plans to have open source sample apps which leverage the SDKs available to you as well. You could use these as reference implementations, a hobby project, or make some tweaks and ship your own streaming channel!

Although the source repositories are not open source yet there are some downloads available now from the website.


The Oddworks Platform is written for the Node.js runtime, and uses the well known Express.js framework for HTTP communication.

Oddworks is designed to be database agnostic so long as the underlying database can support JSON document storage, including some RDMSs like PostgreSQL. Currently the only supported and tested database is Redis.

Although communication between the platforms and the REST API is typically done in a synchronous way, the inner guts of the system is designed to communicate via asynchronous message passing. This makes it easier to extend the platform with plugins and other loosely coupled modules without worrying about upstream changes like you would in tightly coupled platforms.


For transparency into our release cycle and in striving to maintain backward compatibility, Oddworks is maintained under the Semantic Versioning guidelines.


The Oddworks Platform was designed and developed by Odd Networks to lower the barrier for developers and content owners to create your own streaming content channel. Based on our experience in video gaming we thought that TV could use a big improvement. We believe in the future of television and, with the Oddworks open source platform, we hope you'll make that future a reality.

We proudly stand behind our open source work and, in addition to maintaining the Oddworks project, Odd Networks also provides hosted services, a Pro Dashboard, a Live Stream Generator, and a Recommendation Service.

Check out www.oddnetworks.com


Get updates on Odd Networks's development and chat with the project maintainers and community members.

More Information

For additional help getting up and running with Oddworks have a look at this blog post



Apache 2.0 © Odd Networks