b835de2dc4
* Able to authenticate user against IndieAuth. For #1273 * WIP server indieauth endpoint. For https://github.com/owncast/owncast/issues/1272 * Add migration to remove access tokens from user * Add authenticated bool to user for display purposes * Add indieauth modal and auth flair to display names. For #1273 * Validate URLs and display errors * Renames, cleanups * Handle relative auth endpoint paths. Add error handling for missing redirects. * Disallow using display names in use by registered users. Closes #1810 * Verify code verifier via code challenge on callback * Use relative path to authorization_endpoint * Post-rebase fixes * Use a timestamp instead of a bool for authenticated * Propertly handle and display error in modal * Use auth'ed timestamp to derive authenticated flag to display in chat * don't redirect unless a URL is present avoids redirecting to `undefined` if there was an error * improve error message if owncast server URL isn't set * fix IndieAuth PKCE implementation use SHA256 instead of SHA1, generates a longer code verifier (must be 43-128 chars long), fixes URL-safe SHA256 encoding * return real profile data for IndieAuth response * check the code verifier in the IndieAuth server * Linting * Add new chat settings modal anad split up indieauth ui * Remove logging error * Update the IndieAuth modal UI. For #1273 * Add IndieAuth repsonse error checking * Disable IndieAuth client if server URL is not set. * Add explicit error messages for specific error types * Fix bad logic * Return OAuth-keyed error responses for indieauth server * Display IndieAuth error in plain text with link to return to main page * Remove redundant check * Add additional detail to error * Hide IndieAuth details behind disclosure details * Break out migration into two steps because some people have been runing dev in production * Add auth option to user dropdown Co-authored-by: Aaron Parecki <aaron@parecki.com> |
||
|---|---|---|
| .github | ||
| .vscode | ||
| activitypub | ||
| auth | ||
| build | ||
| config | ||
| controllers | ||
| core | ||
| db | ||
| docs | ||
| examples | ||
| geoip | ||
| logging | ||
| metrics | ||
| models | ||
| notifications | ||
| router | ||
| static | ||
| test | ||
| utils | ||
| webroot | ||
| yp | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .golangci.yml | ||
| .prettierignore | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| main.go | ||
| openapi.yaml | ||
| README.md | ||
| renovate.json | ||
| sqlc.json | ||
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
- Getting Started
- Use with your broadcasting software
- Building from source
- Contributing
- License
- Contact
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
- Ensure you have the gcc compiler installed.
- Install the Go toolchain (1.16 or above).
- Clone the repo.
git clone https://github.com/owncast/owncast go run main.gowill run from source.- Visit
http://yourserver:8080to access the web interface orhttp://yourserver:8080/adminto access the admin. - 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:
- From the owncast directory run the packager script:
./build/admin/bundleAdmin.sh - 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
- Install golangci-lint for helpful warnings and suggestions directly in your editor when writing Go.
- If using VSCode install the lit-html extension to aid in syntax highlighting of our frontend HTML + Preact.
- 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