48 lines
1.1 KiB
Markdown
48 lines
1.1 KiB
Markdown
# Owncast webhook server and chat aggregator
|
|
|
|
This project provides a webhook server for Owncast.
|
|
|
|
It implements the webhook triggered when a new message is posted in the chat. It also allows retrieving messages from a Twitch channel and displaying them together on a page that can be embedded into OBS.
|
|
|
|
## Installation
|
|
|
|
### Pre-compiled package
|
|
|
|
Go to [releases](https://gitnet.fr/deblan/owncast-webhook/releases) and download the [latest version](https://gitnet.fr/deblan/owncast-webhook/releases/download/latest/owncast-webhook).
|
|
|
|
### From source
|
|
|
|
Requirements: nodejs (tested with >=22), golang (tested with >=1.24)
|
|
|
|
```
|
|
git clone https://gitnet.fr/deblan/owncast-webhook
|
|
npm i
|
|
make build
|
|
```
|
|
|
|
## Configuration
|
|
|
|
### Server side
|
|
|
|
```
|
|
cp config.ini.example config.ini
|
|
```
|
|
|
|
### Owncast
|
|
|
|
Add a webhook (Integration > Webhooks):
|
|
|
|
- URL: `{server.base_url}/webhook/{server.webhook_secret}/owncast/chat_message`
|
|
- Events: `When a user sends a chat message`
|
|
|
|
### OBS
|
|
|
|
You can embed the chat using this URL: `{server.base_url}/chat/messages`
|
|
|
|
If you use a reverse proxy, configure `{server.base_url}/ws.*` as weboscket.
|
|
|
|
## Usage
|
|
|
|
```
|
|
./owncast-webhook -c ./config.ini
|
|
```
|