mirror of
https://github.com/pinpox/gitea-matrix-bot
synced 2024-11-22 19:31:58 +01:00
A bot to post gitea events to a matrix channel
.gitignore | ||
.travis.yml | ||
bot.go | ||
config.ini.example | ||
gitea-scrot.png | ||
listener_test.go | ||
listener.go | ||
main_test.go | ||
main.go | ||
postdata.go | ||
README.md |
gitea-matrix-bot (WORK IN PROGRESS, ALPHA!)
A bot to listen for gitea webhooks and post to a matrix channel
Usage
Configuration
Copy config.ini.example to config.ini or creat a file called config.ini with the following options:
[http]
# The path the listener will expect the post data
http_uri = "/post"
# The port the listener will listen on
http_port = "9000"
[matrix]
# The matrix server to connect to
matrix_host = "http://matrix.org"
# The matrix room to post to
matrix_room = "#my-awesome-room:matrix.org"
# User credentions of the bot for posting to the room
matrix_pass = "supersecretpass"
matrix_user = "my-awesome-bot"
Then start the bot. It will listen on the configured URI for incoming gitea hooks.
Create gitea hook
Create a new webhook in gitea. You an add a webhook to a single repository or add a default webhook that will apply to all you repos (recommended)
- Choose the Webhook type
Gitea
for you Webhook - Configure which events you want to send. You can also select
All Events
- Set the Target URL to your host + the value you configured in the
config.ini
file. (e.g.http://myserver:9000/post
) - Make sure that port is reachable/forwarded if you are behind a router and check your firewall
- Set
POST Content Type
toapplicatino/json
- Add a secret (passphrase, password)