Take control over your live stream video by running it yourself. Streaming + chat out of the box.
Find a file
2020-11-05 18:29:16 -08:00
.github Trying to fix commits not happening with js 2020-10-30 16:04:03 -07:00
.vscode Fix typo in verbose launch args 2020-10-24 16:01:49 -07:00
build Bump @videojs/http-streaming from 2.2.0 to 2.2.4 in /build/javascript (#322) 2020-11-03 22:44:18 -08:00
config Replace admin broadcaster with status api 2020-11-05 18:29:16 -08:00
controllers Replace admin broadcaster with status api 2020-11-05 18:29:16 -08:00
core Remove stale client purging. Use sockets to count clients. #323 2020-11-05 00:15:00 -08:00
data Render and sanitize chat messages server-side. (#237) 2020-10-13 16:45:52 -07:00
doc/api Commit updated API documentation 2020-10-30 01:42:11 +00:00
geoip Connected clients admin API (#217) 2020-10-06 23:14:33 -07:00
logging Add logging admin APIs for dashboard #114 2020-10-29 18:17:04 -07:00
metrics Fixes #211: Update mod paths (#221) 2020-10-05 10:07:09 -07:00
models Add version number to status endpoint 2020-11-03 21:22:17 -08:00
router Replace admin broadcaster with status api 2020-11-05 18:29:16 -08:00
scripts Move build script to build directory 2020-11-03 00:46:18 -08:00
static [ImgBot] Optimize images (#313) 2020-10-31 13:27:39 -07:00
test Add cleanup to test content script 2020-10-19 21:42:52 -07:00
utils HLS video handling/storage/state refactor (#151) 2020-10-14 14:07:38 -07:00
webroot Bump @videojs/http-streaming from 2.2.0 to 2.2.4 in /build/javascript (#322) 2020-11-03 22:44:18 -08:00
yp Perform validation on YP instance URL value 2020-11-05 09:23:44 -08:00
.editorconfig add starter editorconfig file 2020-08-09 23:44:04 -07:00
.gitattributes Add attributes file 2020-10-05 23:16:11 -07:00
.gitignore First pass at centralized database reference. Closes #282 (#289) 2020-10-26 08:55:31 -07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-07-08 17:08:28 -07:00
config-example.yaml Replace admin broadcaster with status api 2020-11-05 18:29:16 -08:00
Dockerfile Update the dev dockerfile and build dockerfile to fix #60 2020-07-14 17:51:48 -07:00
go.mod Bump github.com/aws/aws-sdk-go from 1.35.20 to 1.35.21 (#325) 2020-11-04 23:33:07 -08:00
go.sum Bump github.com/aws/aws-sdk-go from 1.35.20 to 1.35.21 (#325) 2020-11-04 23:33:07 -08:00
LICENSE Create LICENSE 2020-07-08 17:07:09 -07:00
main.go Add version number to status endpoint 2020-11-03 21:22:17 -08:00
openapi.yaml Add get log apis to doc 2020-10-29 18:41:21 -07:00
README.md Add a link to rocket.chat in the contact section of the readme 2020-10-16 16:12:49 -07:00


Logo

Take control over your content and stream it yourself.
Explore the docs »

View Demo · Use Our Server for Testing · FAQ · Report Bug

Table of Contents

About The Project

In 2020 the world changed when everyone become stuck in their homes, looking for creative outlets to share their art, skills and themselves from inside their bedroom.

This created an explosion of live streaming on Facebook Live, YouTube Live, Instagram, and Twitch. These services provided everything they needed, an easy way to live stream to the world, and a chat for users to be a part of their community.

But in a world where many were previously finding ways to rely on the big internet service companies less, the 2020 COVID-19 pandemic made everyone run right back to them.

And as soon as people started streaming their DJ sets, movie watching parties, and themselves just sitting around listening to music the big companies came to mute their streams, remove their recordings or ban these users all together.

That's when I wanted a better option for people. Something you could run yourself and get all the functionality of these services, where you could live stream to an audience and and allow them to take part in the chat, just like they've been used to on all the other services. But instead of handing control over to somebody else, you run it. You won't get shut down, and you own it all, just like it should be.

I figured you can install Wordpress and self-host your blog, or install Megento and self-host your e-commerce site. You can install Icecast and have your own internet radio station. Spin up an instance of Mastodon and you have your own social media site that you control. You can even install Nextcloud and have your own personal productivity service replacing Dropbox and Google Docs. There's an open-source alternative to all the big services that you can run for almost everything, but I couldn't think of what the live video streaming equivalent was. There should be a independent, standalone Twitch in a Box.

Keep in mind that while streaming to the big social companies is always free, you pay for it with your identity and your data, as well as the identity and data of every person that tunes in. When you self-host anything you'll have to pay with your money instead. But running a self-hosted live stream server can be done for as cheap as $5/mo, and that's a much better deal than selling your soul to Facebook, Google or Amazon.


Getting Started

The goal is to have a single service that you can run and it works out of the box. Visit the Quickstart to get up and running.

Configuration

Many aspects can be adjusted and customized to your preferences. Read more about Configuration to update the web UI, video settings, and more.

Web interface + chat

Owncast includes a web interface to your video with built-in chat that is available once you start the server.

The web interface was specifically built to be editable by anybody comfortable tweaking a web page. It's not bundled or transpiled into anything, it's just HTML + Javascript + CSS that you can start editing.

Read more about the features provided and how to configure them in the web documentation.

Use with your existing broadcasting software

In general Owncast is compatible with any software that uses RTMP to broadcast to a remote server. RTMP is what all the major live streaming services use, so if youre currently using one of those its likely that you can point your existing software at your Owncast instance instead.

OBS, Streamlabs, Restream and many others have been used with Owncast. Read more about compatibility with existing software.

Video storage options

Two ways of storing and distributing the video are supported.

  1. Locally via the built-in web server.
  2. S3-compatible storage.

Local file distribution

This is the simplest and works out of the box. In this scenario video will be served to the public from the computer that is running the server. If you have a fast internet connection, enough bandwidth alotted to you, and a small audience this may be fine for many people.

S3-Compatible Storage

Instead of serving video directly from your personal server you can use a S3 compatible storage provider to offload the bandwidth and storage requirements elsewhere.

Read more detailed documentation about configuration of S3-compatible services.

Building from Source

  1. Ensure you have the gcc compiler configured.
  2. Install the Go toolchain.
  3. Clone the repo. git clone https://github.com/owncast/owncast
  4. Follow the above Getting Started instructions, making sure ffmpeg exists and your config file is set.
  5. go run main.go on the first run will download the required packages needed for the application to build.
  6. It will start running the same as in the above Usage instructions and you can point OBS to your localhost instance of it.

There is also a supplied Dockerfile so you can spin it up from source with little effort. Read more about running from source.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Project chat: Join us on Rocket.Chat if you want to contribute, follow along, or if you have questions.

Gabe Kangas - @gabek@mastodon.social - email gabek@real-ity.com

Project Link: https://github.com/owncast/owncast