1
0
mirror of https://github.com/pinpox/gitea-matrix-bot synced 2024-11-22 19:31:58 +01:00
gitea-matrix-bot/README.md
Pablo Ovelleiro Corral fd12a4c4e3
Update README.md
2019-04-20 22:38:05 +02:00

53 lines
1.7 KiB
Markdown

[![Build Status](https://travis-ci.org/binaryplease/gitea-matrix-bot.svg?branch=master)](https://travis-ci.org/binaryplease/gitea-matrix-bot)
[![GoDoc](https://godoc.org/github.com/binaryplease/gitea-matrix-bot?status.svg)](https://godoc.org/github.com/binaryplease/gitea-matrix-bot)
[![Go Report Card](https://goreportcard.com/badge/github.com/binaryplease/gitea-matrix-bot)](https://goreportcard.com/report/github.com/binaryplease/gitea-matrix-bot)
[![codecov](https://codecov.io/gh/binaryplease/gitea-matrix-bot/branch/master/graph/badge.svg)](https://codecov.io/gh/binaryplease/gitea-matrix-bot)
# gitea-matrix-bot (WORK IN PROGRESS!)
A bot to listen for [gitea](https://gitea.io) webhooks and post to a [matrix](https://matrix.org) channel
Join the support channel for help and discussion:
[https://matrix.to/#/#gitea-matrix-bot:matrix.org](https://matrix.to/#/#gitea-matrix-bot:matrix.org)
# Usage
## Configuration
Copy config.ini.example to config.ini or create a file called config.ini with the
following options:
```ini
[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"
[bot]
# Path of the database to be used
db_path = "./tokens.db"
```
Then start the bot. It will listen on the configured URI for incoming gitea
hooks.
## Create gitea hook
It will probably look like this:
![gitea scrot](./gitea-scrot.png "Gitea Screenshot")