Take control over your live stream video by running it yourself. Streaming + chat out of the box.
Find a file
James Young d1f3fffe2f
reafctor: normalize component formatting (#2082)
* refactor: move/rename BanUserButton file

* refactor: move/rename Chart file

* refactor: update generic component filenames to PascalCase

* refactor: update config component filenames to PascalCase

* refactor: update AdminLayout component filename to PascalCase

* refactor: update/move VideoJS component

* chore(eslint): disable bad react/require-default-props rule

* refactor: normalize ActionButton component

* refactor: normalize ActionButtonRow component

* refactor: normalize FollowButton component

* refactor: normalize NotifyButton component

* refactor: normalize ChatActionMessage component

* refactor: normalize ChatContainer component

* refactor: normalize ChatJoinMessage component

* refactor: normalize ChatModerationActionMenu component

* refactor: normalize ChatModerationDetailsModal component

* refactor: normalize ChatModeratorNotification component

* refactor: normalize ChatSocialMessage component

* refactor: normalize ChatSystemMessage component

* refactor: normalize ChatTextField component

* refactor: normalize ChatUserBadge component

* refactor: normalize ChatUserMessage component

* refactor: normalize ContentHeader component

* refactor: normalize OwncastLogo component

* refactor: normalize UserDropdown component

* chore(eslint): modify react/function-component-definition rule

* refactor: normalize CodecSelector component

* refactor: update a bunch of functional components using eslint

* refactor: update a bunch of functional components using eslint, pt2

* refactor: update a bunch of functional components using eslint, pt3

* refactor: replace all component->component default imports with named imports

* refactor: replace all component-stories->component default imports with named imports

* refactor: remove default exports from most components

* chore(eslint): add eslint config files for the components and pages dirs

* fix: use-before-define error in ChatContainer

* Fix ChatContainer import

* Only process .tsx files in Next builds

Co-authored-by: Gabe Kangas <gabek@real-ity.com>
2022-09-07 00:00:28 -07:00
.github Tweak Chromatic job 2022-09-06 18:03:37 -07:00
.vscode Add support for IP-based bans (#1703) 2022-03-06 20:34:49 -08:00
activitypub Merge branch 'develop' into webv2 2022-08-09 14:14:45 -07:00
auth Fix creating table indexes 2022-08-03 10:31:14 -07:00
build Lock file maintenance 2022-08-27 20:29:23 -07:00
config Merge remote-tracking branch 'origin/develop' into webv2 2022-08-15 23:25:08 -07:00
controllers Add custom offline message+api. Part of #1901 2022-08-09 22:09:43 -07:00
core Remove package-comments rule 2022-08-27 20:31:00 -07:00
db Add support for changing user color in name modal. Closes #1805 2022-08-09 19:56:45 -07:00
docs Merge remote-tracking branch 'origin/develop' into webv2 2022-08-15 23:25:08 -07:00
examples Remove overly complex and specific docker-compose examples. Closes #1475 2021-10-21 11:48:21 -07:00
geoip refactor geoip (#1442) 2021-10-12 13:21:37 -07:00
logging Expanded linting + fix warnings (#1396) 2021-09-12 00:18:15 -07:00
metrics Fix up the wasted CPU transcoding alert message 2022-05-11 17:00:23 -07:00
models Add Fediverse, Matrix and XMPP social links (#2044) 2022-08-27 20:26:07 -07:00
notifications Fix creating table indexes 2022-08-03 10:31:14 -07:00
router Add custom offline message+api. Part of #1901 2022-08-09 22:09:43 -07:00
static Bundle embedded web app 2022-09-07 06:34:12 +00:00
test Run API tests inside Eartlhly 2022-09-04 17:14:44 -07:00
utils Add support for changing user color in name modal. Closes #1805 2022-08-09 19:56:45 -07:00
web reafctor: normalize component formatting (#2082) 2022-09-07 00:00:28 -07:00
webroot Prettified Code! 2022-08-27 20:26:07 -07:00
yp refactor: move from io/ioutil to io and os packages (#1546) 2021-11-19 22:42:50 -08:00
.editorconfig Update EditorConfig with some explicit settings 2022-07-21 00:13:25 -07:00
.gitattributes doc -> docs as Github needs a specific name 2022-03-19 12:02:34 -07:00
.gitignore Typo in gitignore 2022-04-06 22:43:47 -07:00
.golangci.yml Remove package-comments rule 2022-08-27 20:31:00 -07:00
.prettierignore Added moderator menu to messages and some other styling. 2022-07-01 22:53:56 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-07-08 17:08:28 -07:00
CONTRIBUTING.md Create CONTRIBUTING.md (#1394) 2021-09-10 12:36:42 -07:00
Dockerfile Change CMD to ENTRYPOINT (#1831) 2022-04-15 13:56:12 -07:00
Earthfile Run API tests inside Eartlhly 2022-09-04 17:14:44 -07:00
go.mod Update module github.com/microcosm-cc/bluemonday to v1.0.20 2022-09-06 16:06:36 +00:00
go.sum Update module github.com/microcosm-cc/bluemonday to v1.0.20 2022-09-06 16:06:36 +00:00
LICENSE Create LICENSE 2020-07-08 17:07:09 -07:00
main.go Fix "invalid cross-device link" error when running on a different filesystem (#1769) 2022-03-07 16:30:40 -08:00
openapi.yaml Merge remote-tracking branch 'origin/develop' into webv2 2022-07-11 21:21:07 -07:00
README.md Tweak readme to reference the web project accurately. 2022-07-23 14:35:56 -07:00
renovate.json Move baseBranches config option to top level 2022-08-15 08:39:44 -07:00
sqlc.yaml Messages table fixes to improve query performance (#2026) 2022-08-03 10:21:55 -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

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

Owncast consists of two projects.

  1. The Owncast backend written in Go.
  2. The frontend written in React.

Read more about running from source.

Backend

The Owncast backend is a service written in Go.

  1. Ensure you have a c 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.

Frontend

The frontend is the web interface that includes the player, chat, embed components, and other UI.

  1. This project lives in the web directory.
  2. Run npm install to install the Javascript dependencies.
  3. Run npm run dev

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.

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@social.gabekangas.com - email gabek@real-ity.com

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