f81e8dcda7
* Mute the 'stream ended' clip's audio The 'stream ended' clip plays at the at the end of every stream broadcast using owncast. It currently contains audio that peaks at -7.1db. (according to ffmpeg's volumedetect audio filter) This can result in a bad experience for viewers if the stream that they were just watching had a much lower average volume, and they had turned up their speakers or headphones to compensate. In extreme cases this could theoretically cause harm to viewers and/or their equipment. As an admin running owncast, there is no way to remove this audio *except* for patching the file. Even if you do patch the file, you need to notify your viewers to clear their browser caches if they have ever seen the clip, because offline.ts has a cache-control max-age header specifying 365 days. The caching of the previous version of this clip is out of scope of this PR. This issue is discussed in more detail in #1965. Unlike my previous attempt in #3332, which removed the audio track, this PR *mutes* the audio. Specifically, I used this ffmpeg command: ``` ffmpeg -i offline.ts -filter:a "volume=0.0" output.ts ``` There are no other modifications to the clip. * Commit updated API documentation * feat(video): make compatible muted offline clip. Rename clip as a v2 so it is not cached * Fix conflict * force add new offline file --------- Co-authored-by: vivlim <vivlim@vivl.im> Co-authored-by: Owncast <owncast@owncast.online> Co-authored-by: Gabe Kangas <gabek@real-ity.com>
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
Owncast consists of two projects.
- The Owncast backend is written in Go.
- The frontend is written in React.
Read more about running from source.
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.
Backend
The Owncast backend is a service written in Go.
- Ensure you have prerequisites installed.
- C compiler, such as GCC compiler or a Musl-compatible compiler
- ffmpeg
- Install the Go toolchain (1.21 or above).
- Clone the repo.
git clone https://github.com/owncast/owncast go run main.gowill run from the 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.
Frontend
The frontend is the web interface that includes the player, chat, embed components, and other UI.
- This project lives in the
webdirectory. - Run
npm installto install the Javascript dependencies. - 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 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.
License
Distributed under the MIT License. See LICENSE for more information.
Supported by
- This project is tested with BrowserStack.
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