my fork of Gabes awesome self hosted live stream publishing software https://github.com/owncast/owncast
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
forest 4c8bb05fe2 update admin panel with self-destruct button and fix nil pointer in yp 3 months ago
.github let actions/checkout@v2 select the right reference for push and pull request events (#1042) 4 months ago
.vscode first test build with direct HLS streaming from a samba share 4 months ago
build Bump @videojs/http-streaming from 2.8.1 to 2.8.2 in /build/javascript (#1034) 4 months ago
config first test build with direct HLS streaming from a samba share 4 months ago
controllers remove unused code 3 months ago
core username and password support for hls + finishing up retry stuff 3 months ago
doc/api Commit updated API documentation 5 months ago
examples Banjo/owncast systemd service (#749) 7 months ago
geoip 0.0.6 -> Master (#731) 7 months ago
logging Save owncast logs to log file. Closes #908 4 months ago
metrics Display the current value not the threshold 6 months ago
models Active viewer PING controller. Closes #790 (#990) 4 months ago
router adding self-destruct endpoint for restarting the server from admin panel 3 months ago
static Fix metadata.html crash. Closes #746. Re: #685 7 months ago
test Remove prefixed whitespace in markdown rendering 4 months ago
utils Remove prefixed whitespace in markdown rendering 4 months ago
webroot Merge branch 'separate-logo-and-offline-stream-image' into develop 3 months ago
yp update admin panel with self-destruct button and fix nil pointer in yp 3 months ago
.editorconfig add starter editorconfig file 1 year ago
.gitattributes gitattributes linguist overrides are not recursive 5 months ago
.gitignore gitignore webroot.json 4 months ago
.golangci.yml Use a golangci-lint workflow to check for common mistakes & problems (#353) 10 months ago
.prettierignore Format javascript on push 7 months ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 1 year ago
Dockerfile optimize samba client: only grab the playlist and new segments 3 months ago
LICENSE Create LICENSE 1 year ago
README.md Add documentation section for how to build in admin (#604) 8 months ago
forest-notes.md fixing bugs & testing direct hls 4 months ago
go.mod first test build with direct HLS streaming from a samba share 4 months ago
go.sum first test build with direct HLS streaming from a samba share 4 months ago
main.go Save owncast logs to log file. Closes #908 4 months ago
nsswitch.conf optimize samba client: only grab the playlist and new segments 3 months ago
openapi.yaml first test build with direct HLS streaming from a samba share 4 months ago
pkged.go update admin panel with self-destruct button and fix nil pointer in yp 3 months ago

README.md


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.

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. 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 you’re currently using one of those it’s 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 Owncast 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. go run main.go pkged.go will run from source.
  5. Point your broadcasting software at your new server and start streaming.

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

Bundling in latest admin from source

The admin ui is built at: https://github.com/owncast/owncast-admin it is bundled into the final binary using pkger.

To bundle in the latest admin UI:

  1. Install pkger. go install github.com/markbates/pkger/cmd/...
  2. From the owncast directory run the packager script: ./build/admin/bundleAdmin.sh
  3. Compile or run like above. go run main.go pkged.go

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