You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Takes in webhooks that originate from Sonarr and are intended for Discord. It catches "Grabbed" and "imported" notifications from Sonarr, uses some timers to add a delay in which it can catch and group together many notifications by show and season, then pass those groupings along to the intended Discord webhook URL. Sonarr should probably have this built in.... but until then I made this. I don't really expect anyone else to use this, this is my first (and last for a while) Go project and helps solve an annoyance.
5
+
Takes in webhooks that originate from Sonarr and are intended for Discord. It catches grab, import, and upgrade event notifications from Sonarr, uses some timers to add a delay in which it can catch and group together many notifications by show and season, then pass those groupings along to the intended Discord webhook URL. Sonarr should probably have this built in.... but until then I made this.
6
+
7
+
Hookbuffer keeps separate queues of messages for each Discord URL it recieves notifications for. This allows 1 Hookbuffer instance to be used for multiple Sonarr instances which go to different destinations without messages getting crossed, which is why I have Hookbuffer deployed to the cloud.
6
8
7
9
Main benefits:
8
10
- Use Sonarr notifications without as much spam
@@ -11,22 +13,44 @@ Main benefits:
11
13
12
14
#### Example:
13
15
14
-

16
+

15
17
16
-
Instead of 9 separate Discord messages (one per episode), Hookbuffer groups them by season and sends them to Discord.
18
+
Instead of 60+ separate Discord messages (one per episode), Hookbuffer groups them by season and sends them to Discord.
17
19
18
-
### Usage:
20
+
### Usage:
19
21
20
-
It's on Dockerhub: https://hub.docker.com/r/cbackas/hookbuffer
22
+
#### Deploying App
21
23
22
-
```docker run --name hookbuffer -p 5369:5369 cback/hookbuffer:latest```
24
+
Docker image can be found on Github Container Registry: https://github.com/cbackas/hookbuffer/pkgs/container/hookbuffer
23
25
24
-
Or you can build it and run it using commands
26
+
`docker run --name hookbuffer -p 8000:8000 ghcr.io/cbackas/hookbuffer:latest`
27
+
28
+
#### Authentication:
29
+
If you deploy this container on the same local network as your Sonarr instance, you don't really need authentication. But if you deploy it to tyhe cloud, you should enable hookbuffer's auth feature. You can add authentication checks by setting the `HOOKBUFFER_USER` and `HOOKBUFFER_PASS` environment variables, ex:
-`HOOKBUFFER_PORT` - Port to listen on inside container (default 8000)
34
+
-`HOOKBUFFER_DESTINATION_URL` - The URL used to send the grouped webhooks to. Defaults to `https://discordapp.com/`
25
35
26
-
```go build cmd/hookbuffer```
36
+
#### Configuring Sonarr
37
+
First you need to create a Discord webhook in the Discord channel you want to send notifications to. You can do this by going to the channel settings, then "Integrations" and "Webhooks". Create a webhook and copy the URL. More here: https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks
27
38
28
-
```./hookbuffer```
39
+
Next we need to configure Sonarr to send notifications through Hookbuffer.
40
+
1. Go to Sonarr -> Settings -> Connect
41
+
2. Create new connection, choose "Webhook" as the connection type
42
+
3. Give the connection a name and *enable the "On Grab", "On Import", and "On Upgrade" triggers*
43
+
4. Configure Webhook URL
44
+
a. Paste your Discord webhook URL into the "Webhook URL" field
45
+
b. Replace the "https://discordapp.com/" part of the URL with 'http://\<hookbuffer_host_ip\>:\<hookbuffer_port\>' (example: https://discordapp.com/api/webhooks/12345678910/abcdefghijklmnopqrstuvwxyz -> http://192.168.0.30:8000/api/webhooks/12345678910/abcdefghijklmnopqrstuvwxyz)
46
+
5. Optional: If you configured the `HOOKBUFFER_USER` and `HOOKBUFFER_PASS` env variables, then you can put those values into the "Username" and "Password" fields
47
+
6. Test and Save the connection
29
48
30
-
Then in Sonarr, go to "Connections" and set up a Discord connection, get a webhook URL from your Discord client, paste that URL and replace https://discordapp.com/ with http://\<host ip\>:5369/ (retaining /api/webhooks/ and everything after it) (Example: https://i.imgur.com/RvZUMOk.png)
0 commit comments