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!
- Documentation
- Platform
- Content Server
- platform SDKs
- Technology
- Versioning
- Motivation
- Community
- License
Read up on the platform.
The Oddworks Platform consists of two main concepts:
- The Oddworks Content Server which maintains a database of your content and provides it to your apps via a strictly specified JSON API.
- 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.
> npm install @oddnetworks/oddworks
In your server script:
const oddworks = require('oddworks');
The Oddworks CLI is also available
> npm install -g @oddnetworks/oddworks-cli
We plan to have many, but our current example applications can be found (with their instructions) here:
The Oddworks Content Server is made up of several loosely coupled services.
- Identity (responsible for channels, platforms, users, authentication, and entitlements)
- Catalog (responsible for views, collections, and videos)
- JSON API (responsible for decorating responses into the JSON API Spec format)
The implementation of these can be found in the /services folder.
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 we have official support for the following:
- In-memory (best used for development and testing)
- Redis
- Redis Search (a full text search implementation based on the N-gram algorithm)
- MongoDB (coming soon)
- Elasticsearch (coming soon)
With the stores above you can pick your poison for your specific needs.
The implementation of these can be found in the /stores folder.
All of these components are automatically installed as dependencies when you setup the Oddworks Content Server. Oddworks uses NPM for dependency and package management (see Technology below).
- Apple iOS & tvOS SDK Used for iPhone, iPad, and Apple TV.
- Android SDK Used for mobile, tablet, Android TV, and Fire TV.
Coming soon:
- Roku SDK
- JavaScript SDK for use in Windows Universal and web applications.
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 MongoDB.
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.
- Follow @oddnetworks on Twitter.
- Join the official Slack room.
- Submit an issue.
- Check out the API sample responses.
- Read and subscribe to The Official Odd Networks Blog.
For additional help getting up and running with Oddworks have a look at this blog post
Apache 2.0 © Odd Networks