Take control over your live stream video by running it yourself. Streaming + chat out of the box.
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.
 
 
 
 
 
renovate[bot] 99d6bc714c
fix(deps): update module github.com/aws/aws-sdk-go to v1.44.149 (#2396)
2 days ago
.github Revert "Tweak Renovate options for automerge" 1 month ago
.vscode Add support for IP-based bans (#1703) 9 months ago
activitypub Explicitly set AP post as public. Closes #2112 2 weeks ago
auth Treat fediverse usernames as case-insensitive (#2155) 2 months ago
build chore(deps): lock file maintenance 4 days ago
config Bump version for 0.0.13 release 4 days ago
controllers preallocate memory (#2201) 2 months ago
core Using prepared statements for SQL queries. (#2257) 1 month ago
db Remove unused query 4 months ago
docs Commit updated API documentation 4 days ago
examples Update service to be far more secure. (#2352) 2 weeks ago
geoip refactor geoip (#1442) 1 year ago
logging Expanded linting + fix warnings (#1396) 1 year ago
metrics Fix up the wasted CPU transcoding alert message 7 months ago
models Add Fediverse, Matrix and XMPP social links (#2044) 4 months ago
notifications Fix creating table indexes 4 months ago
router Set ReadHeaderTimeout in http server 5 months ago
static Update admin to 19c9ac698ac49922046fd8f2a5b0b816dc6e921a 5 months ago
test Bump socket.io-parser from 3.3.2 to 3.3.3 in /test/load (#2323) 3 weeks ago
utils Add a bit of sanity to the stream health messages 8 months ago
webroot Prettified Code! 2 weeks ago
yp refactor: move from io/ioutil to io and os packages (#1546) 1 year ago
.editorconfig Change .editorconfig to reflect current state of the code (#1944) 6 months ago
.gitattributes doc -> docs as Github needs a specific name 9 months ago
.gitignore Typo in gitignore 8 months ago
.gitpod.yml Add Gitpod config (#2173) 2 months ago
.golangci.yml Remove package-comments rule 3 months ago
.prettierignore Format javascript on push 2 years ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2 years ago
CONTRIBUTING.md Create CONTRIBUTING.md (#1394) 1 year ago
Dockerfile Revert "Add va-api support in docker (#2072)" 2 months ago
Earthfile Revert "Add va-api support in docker (#2072)" 2 months ago
LICENSE Create LICENSE 2 years ago
README.md updated README with minimum go version required to compile (#2239) 1 month ago
go.mod fix(deps): update module github.com/aws/aws-sdk-go to v1.44.149 (#2396) 2 days ago
go.sum fix(deps): update module github.com/aws/aws-sdk-go to v1.44.149 (#2396) 2 days ago
main.go Fix "invalid cross-device link" error when running on a different filesystem (#1769) 9 months ago
openapi.yaml Bump version for 0.0.13 release 4 days ago
renovate.json Cleanup and refactor Renovate config 3 days ago
sqlc.yaml Messages table fixes to improve query performance (#2026) 4 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

Owncast is an open source, self-hosted, decentralized, single user live video streaming and chat server for running your own live streams similar in style to the large mainstream options. It offers complete ownership over your content, interface, moderation and audience. Visit the demo for an example.


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.

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.

Building from Source

  1. Ensure you have pre-requisites installed.
  2. Install the Go toolchain (1.17 or above).
  3. Clone the repo. git clone https://github.com/owncast/owncast
  4. go run main.go will run from source.
  5. Visit http://yourserver:8080 to access the web interface or http://yourserver:8080/admin to access the admin.
  6. 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. From the owncast directory run the packager script: ./build/admin/bundleAdmin.sh
  2. Compile or run like above. go run main.go

Contributing

Owncast is a growing open source project that is giving freedom, flexibility and fun to live streamers. And while we have a small team of kind, talented and thoughtful volunteers, we have gaps in our skillset that we’d love to fill so we can get even better at building tools that make a difference for people.

We abide by our Code of Conduct and feel strongly about open, appreciative, and empathetic people joining us. We’ve been very lucky to have this so far, so maybe you can help us with your skills and passion, too!

There is a larger, more detailed, and more up-to-date guide for helping contribute to Owncast on our website.

Architecture

Owncast consists of two repositories with two standalone projects. The repo you're looking at now is the core repository with the backend and frontend. owncast/owncast-admin is an additional web project that is built separately and used for configuration and management of an Owncast server.

Suggestions when working with the Owncast codebase

  1. Install golangci-lint for helpful warnings and suggestions directly in your editor when writing Go.
  2. If using VSCode install the lit-html extension to aid in syntax highlighting of our frontend HTML + Preact.
  3. Run the project with go run main.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 - @[email protected] - email [email protected]

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