Go to file
t1enne 26f9a41508 Few changes to chat
Added moderator icon

changed styling for a name change message

Now usernames collapse as long as the user is the same

Imported two weights of Poppins and the OpenSans variable instead of def
400

This is some progress on #1859 and #1625
2022-07-02 09:08:36 +02:00
.github Limit what GitHub actions need to run for specific directories 2022-06-29 14:39:33 -07:00
.vscode
activitypub Use bundled images instead of old webroot files 2022-06-20 22:10:55 -07:00
auth
build First pass at bundling web app into service. Working. 2022-06-19 15:32:42 -07:00
config Support a custom emoji override directory. Closes #1967 2022-06-25 23:06:31 -07:00
controllers Add option to hide viewer count. Closes #1939 2022-06-26 00:46:55 -07:00
core Add option to hide viewer count. Closes #1939 2022-06-26 00:46:55 -07:00
db IndieAuth support (#1811) 2022-04-21 14:55:26 -07:00
docs Commit updated API documentation 2022-06-29 02:05:28 +00:00
examples
geoip
logging
metrics
models
notifications
router Add option to hide viewer count. Closes #1939 2022-06-26 00:46:55 -07:00
static Move the favicons 2022-06-24 21:53:16 -07:00
test Add option to hide viewer count. Closes #1939 2022-06-26 00:46:55 -07:00
utils Use a numbered pre-named set of user colors instead of random. Closes #1974 2022-06-28 19:01:47 -07:00
web Few changes to chat 2022-07-02 09:08:36 +02:00
webroot Move the favicons 2022-06-24 21:53:16 -07:00
yp refactor: move from io/ioutil to io and os packages (#1546) 2021-11-19 22:42:50 -08:00
.editorconfig Add explicit editorconfig block for yaml 2022-06-29 14:29:17 -07:00
.gitattributes
.gitignore
.golangci.yml
.prettierignore Added moderator menu to messages and some other styling. 2022-07-01 22:53:56 +02:00
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dockerfile
Earthfile Add unit and api tests to Earthfile 2022-06-21 12:16:44 -07:00
go.mod
go.sum
LICENSE
main.go
openapi.yaml Use a numbered pre-named set of user colors instead of random. Closes #1974 2022-06-28 19:01:47 -07:00
README.md Merge remote-tracking branch 'origin/develop' into webv2 2022-06-19 13:52:22 -07:00
renovate.json
sqlc.json


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 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.

Building from Source

Backend

The Owncast backend is a service written in Go.

  1. Ensure you have the gcc compiler installed.
  2. Install the Go toolchain (1.16 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.

Frontend

The Owncast Web Frontend is a React application that is worked on seperately from the backend. Visit the web readme for details.

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 wed 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. Weve 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.

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 - @gabek@fosstodon.org - email gabek@real-ity.com

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