Build on top of Owncast
The full API documentation can be found here.
Owncast has the ability for you to build things on top of it. Here’s some examples of things you can build:
- A chat bot that replies to keywords or commands.
- An OBS overlay so when an event happens in the chat an image or message shows up on the stream.
- An integration into some kind of 3rd party service, such as when the song you’re listening to changes it shows up in the chat.
- Send out a message to your social networks each time you go live.
- In any language, on any kind of web server, create an endpoint that accepts a HTTP
POSTrequest. This is where Owncast will be sending events.
- Each event payload will have a
typeproperty that states what of the above events are included, and an
eventDataobject that includes all the specific properties of this event.
- If you need a starting point see our example projects.
The following are some tools that might make building a bit easier.
You can host your software anywhere and write it in any language.
A quick, easy and free way to get up and running to experiment is by using Glitch. You can create a free account and write a Node.js application that can accept webhooks and send requests to your Owncast server. You can edit code right in the browser and it’s immediately available to the world. You can always move your code to another server when you’re done if you don’t want to keep it on Glitch.