Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/owncast/owncast

Take control over your live stream video by running it yourself. Streaming + chat out of the box.
https://github.com/owncast/owncast

broadcasting chat golang hacktoberfest hls live livestream owncast rtmp self-hosted streaming-video video

Last synced: 5 days ago
JSON representation

Take control over your live stream video by running it yourself. Streaming + chat out of the box.

Host: GitHub
URL: https://github.com/owncast/owncast
Owner: owncast
License: mit
Created: 2020-05-24T00:58:13.000Z (over 4 years ago)
Default Branch: develop
Last Pushed: 2024-04-14T00:24:33.000Z (8 months ago)
Last Synced: 2024-04-14T02:38:39.943Z (8 months ago)
Topics: broadcasting, chat, golang, hacktoberfest, hls, live, livestream, owncast, rtmp, self-hosted, streaming-video, video
Language: TypeScript
Homepage: https://owncast.online
Size: 736 MB
Stars: 8,869
Watchers: 102
Forks: 788
Open Issues: 183
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: docs/SECURITY.md

Awesome Lists containing this project

awesome-go - owncast/owncast
awesome-github-repos - owncast/owncast - Take control over your live stream video by running it yourself. Streaming + chat out of the box. (Go)
awesome-repositories - owncast/owncast - Take control over your live stream video by running it yourself. Streaming + chat out of the box. (Go)
awesome-starts - owncast/owncast - Take control over your live stream video by running it yourself. Streaming + chat out of the box. (Go)
awesome-starred - owncast/owncast - Take control over your live stream video by running it yourself. Streaming + chat out of the box. (self-hosted)
my-awesome - owncast/owncast - hosted,streaming-video,video pushed_at:2024-12 star:9.6k fork:0.9k Take control over your live stream video by running it yourself. Streaming + chat out of the box. (Go)
awesome-homelab - Owncast

README

Take control over your content and stream it yourself.

Explore the docs »

View Demo
·
FAQ
·
Report Bug

## Table of Contents

- 📒 [About the Project](#about-the-project)
- 🚀 [Getting Started](#getting-started)
- 👨‍💻 [Use with your broadcasting software](#use-with-your-existing-broadcasting-software)
- 🛠 [Building from source](#building-from-source)
- 🚨 [Important note about source code and the develop branch](#important-note-about-source-code-and-the-develop-branch)
- 🗄️ [Backend](#backend)
- ⚛️ [Frontend](#frontend)
- 👏 [Contributing](#contributing)
- 💵 [Donors](#donors)
- 📝 [License](#license)
- [Contact](#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](https://owncast.online/docs/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](https://owncast.online/docs/broadcasting/).

## Building from Source

Owncast consists of two projects.

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

[Read more about running from source](https://owncast.online/development/).

### Important note about source code and the develop branch

The `develop` branch is always the most up-to-date state of development and this may not be what you always want. If you want to run the latest released stable version, check out the tag related to that release. For example, if you'd only like the source prior to the v0.1.0 development cycle you can check out the `v0.0.13` tag.

> Note: Currently Owncast does not natively support Windows servers. However, Windows Users can use Windows Subsystem for Linux (WSL2) to install Owncast. For details visit [this document](https://github.com/owncast/owncast/blob/develop/contrib/owncast_for_windows.md).

### Backend

The Owncast backend is a service written in Go.

1. Ensure you have prerequisites installed.
- C compiler, such as [GCC compiler](https://gcc.gnu.org/install/download.html) or a [Musl-compatible compiler](https://musl.libc.org/)
- [ffmpeg](https://ffmpeg.org/download.html)
1. Install the [Go toolchain](https://golang.org/dl/) (1.22 or above).
1. Clone the repo. `git clone https://github.com/owncast/owncast`
1. `go run main.go` will run from the source.
1. Visit `http://yourserver:8080` to access the web interface or `http://yourserver:8080/admin` to access the admin.
1. Point your [broadcasting software](https://owncast.online/docs/broadcasting/) 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.
1. Run `npm install` to install the Javascript dependencies.
1. 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 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](https://owncast.online/contribute/) 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!

If you're new to the project, maybe you'd be interested in looking at [![Good First Issue](https://img.shields.io/github/issues/owncast/owncast/good%20first%20issue.svg)](https://github.com/owncast/owncast/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).

There is a larger, more detailed, and more up-to-date [guide for helping contribute to Owncast on our website](https://owncast.online/help/).

### Donors
The Owncast project is possible thanks to the people who make a donation to support us and our work.
Thank you to all our donors who help keep Owncast running by donating on OpenCollective. You can support this project by [becoming a backer/sponsor](https://opencollective.com/owncast#suppor).

## License

Distributed under the MIT License. See `LICENSE` for more information.

## Support

Browser testing via

Project chat provided by

CDN services by

UI testing with Chromatic

## Contact

Project chat: [Join us on Rocket.Chat](https://owncast.rocket.chat/home) if you want to contribute, follow along, or if you have questions.

Gabe Kangas - [@[email protected]](https://social.gabekangas.com/gabek) - email [[email protected]](mailto:[email protected])

Project Link: [https://github.com/owncast/owncast](https://github.com/owncast/owncast)