gh-bot
gh-bot is maybe the worst (but simplest) Matrix webhook bot for Github.
Setting up
Server
You will need a secret key, generate one like this:
ruby -rsecurerandom -e 'puts SecureRandom.hex(20)'
A user token and a Matrix homeserver URL.
Here is an example docker-compose:
version: '2.1'
services:
image: ghcr.io/jaedotmoe/gh-bot:latest
environment:
- SEC_TOKEN=72f38e4c61b28f1c9a17868750f48330e47abd12dummy
- MATRIX_TOKEN=syt_028ifji4jf82jf20983j03ijdummy
- MATRIX_HOMESERVER=matrix.example.com
ports:
- 5000:5000
Now login and join rooms you want your bot to send the status messages in.
Warning: the bot will send statuses in every it is in with no exceptions!
Github
Go to your Github repository setting, Webhooks and Add Webhook.
There, set these values:
- Payload URL: Your exposed URL, for instance
https://example.com/gh/webhook
- Content type:
application/json
- Secret: your generated secret, for instance
72f38e4c61b28f1c9a17868750f48330e47abd12dummy
- Which events would you like to trigger this webhook: Send me everything.
And then hit Add Webhook.
You are now good to go!
Support
If you need any help, join the Matrix room.