You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jae Lo Presti 5068962f05
Merge pull request #11 from jae1911/dependabot/pip/waitress-2.1.2
8 months ago
.github/workflows Update docker.yml 11 months ago
data Data: add example images for Readme 1 year ago
handlers Gitlab: add log to rooms 1 year ago
utils Matrix connector: allow selection of protocol via ENV variable 10 months ago
.dockerignore Dockerignore: ignore git & data paths 1 year ago
.gitignore Gitignore: add base gitignore 1 year ago
Dockerfile Dockerfile: add dockerfile 1 year ago
LICENSE ADD LICENSE 1 year ago Readme: add logging documentation 1 year ago Main: change join delay to 5 seconds to add "snappiness" 1 year ago WSGI: add production WSGI 1 year ago
requirements.txt Bump waitress from 2.1.1 to 2.1.2 8 months ago


gh-bot is maybe the worst (but simplest) Matrix webhook bot for Github.

Example of commits: Screenshot of Element showing a list of commits sent by the bot.

Example of workflow finished: Screenshot of Element showing a workflow ended event.

Setting up


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'

    - SEC_TOKEN=72f38e4c61b28f1c9a17868750f48330e47abd12dummy
    - MATRIX_TOKEN=syt_028ifji4jf82jf20983j03ijdummy
    - 5000:5000

You can also add - LOG_ALL_EVENTS=true to the environment variables to log every event sent to webhooks to all rooms via a fi.jae.webhooklog event.

Now, you can invite the bot and it will auto-join room it is invited in every 15 seconds.


Go to your Github repository setting, Webhooks and Add Webhook.
There, set these values:

  • Payload URL: Your exposed URL, for instance
  • 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!


Go to your repo settings, Webhooks and fill with this data:

  • URL: your exposed URL, for instance:
  • Secret token: your generated secret, for instance 72f38e4c61b28f1c9a17868750f48330e47abd12dummy
  • Trigger: select events you want to receive

And then click on 'Add Webhook' and there you go!


Go to your repo settings, Webhooks, Add Webhook, Gitea:

  • Target URL: your endpoint
  • POST Content Type: application/json
  • Secret: your secret, for instance 72f38e4c61b28f1c9a17868750f48330e47abd12dummy
  • Trigger on: all events

Then click 'Add Webhook'.


If you need any help, join the Matrix room.