2019-04-13 22:35:33 +02:00
|
|
|
[](https://travis-ci.org/binaryplease/gitea-matrix-bot)
|
|
|
|
|
[](https://godoc.org/github.com/binaryplease/gitea-matrix-bot)
|
|
|
|
|
[](https://goreportcard.com/report/github.com/binaryplease/gitea-matrix-bot)
|
|
|
|
|
[](https://codecov.io/gh/binaryplease/gitea-matrix-bot)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2019-04-20 22:25:02 +02:00
|
|
|
# gitea-matrix-bot (WORK IN PROGRESS!)
|
2019-04-13 21:59:16 +02:00
|
|
|
|
2019-04-13 22:22:00 +02:00
|
|
|
A bot to listen for [gitea](https://gitea.io) webhooks and post to a [matrix](https://matrix.org) channel
|
2019-04-13 22:17:51 +02:00
|
|
|
|
|
|
|
|
# Usage
|
|
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
Copy config.ini.example to config.ini or creat a file called config.ini with the
|
|
|
|
|
following options:
|
|
|
|
|
|
2019-04-13 22:19:00 +02:00
|
|
|
```ini
|
2019-04-13 22:17:51 +02:00
|
|
|
[http]
|
|
|
|
|
# The path the listener will expect the post data
|
|
|
|
|
http_uri = "/post"
|
|
|
|
|
# The port the listener will listen on
|
|
|
|
|
http_port = "9000"
|
|
|
|
|
|
2019-04-20 22:25:02 +02:00
|
|
|
|
2019-04-13 22:17:51 +02:00
|
|
|
[matrix]
|
|
|
|
|
# The matrix server to connect to
|
|
|
|
|
matrix_host = "http://matrix.org"
|
2019-04-20 22:25:02 +02:00
|
|
|
# The matrix room to post to
|
|
|
|
|
matrix_room = "#my-awesome-room:matrix.org"
|
2019-04-13 22:17:51 +02:00
|
|
|
# User credentions of the bot for posting to the room
|
|
|
|
|
matrix_pass = "supersecretpass"
|
|
|
|
|
matrix_user = "my-awesome-bot"
|
2019-04-20 22:25:02 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
[bot]
|
|
|
|
|
# Path of the database to be used
|
|
|
|
|
db_path = "./tokens.db"
|
2019-04-13 22:17:51 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
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` to `applicatino/json`
|
|
|
|
|
- Add a secret (passphrase, password)
|
|
|
|
|
|
2019-04-13 22:19:38 +02:00
|
|
|
It will probably look like this:
|
2019-04-13 22:17:51 +02:00
|
|
|
|
