hookshot/README.md

43 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

Matrix Hookshot
2021-11-22 17:06:48 +00:00
===============
2019-08-02 19:15:33 +01:00
2022-01-14 19:22:37 +00:00
[![#hookshot:half-shot.uk](https://img.shields.io/matrix/hookshot:half-shot.uk.svg?server_fqdn=chaotic.half-shot.uk&label=%23hookshot:half-shot.uk&logo=matrix)](https://matrix.to/#/#hookshot:half-shot.uk)
[![Docker Image Version (latest by date)](https://img.shields.io/docker/v/halfshot/matrix-hookshot?sort=semver)](https://hub.docker.com/r/halfshot/matrix-hookshot)
2019-08-07 18:56:50 +01:00
![screenshot](screenshot.png)
A Matrix bot for connecting to external services like GitHub, GitLab, JIRA, and more.
- Several services are supported out of the box.
- [Webhooks](https://matrix-org.github.io/matrix-hookshot/latest/setup/webhooks.html) let you connect all kinds of services, with the ability to write rich templates using JavaScript.
- **No external database** is required, instead using Matrix state as a persistent store.
- End-to-Bridge encryption allows bots to be used in encrypted Matrix rooms.
- [Powerful widgets](https://matrix-org.github.io/matrix-hookshot/latest/advanced/widgets.html) let you configure Hookshot from a room or the Element Extensions Store.
2019-08-07 18:56:50 +01:00
We richly support the following integrations:
- [Figma](https://matrix-org.github.io/matrix-hookshot/latest/setup/figma.html)
- [Generic Webhooks](https://matrix-org.github.io/matrix-hookshot/latest/setup/webhooks.html)
- [GitHub](https://matrix-org.github.io/matrix-hookshot/latest/setup/github.html)
- [GitLab](https://matrix-org.github.io/matrix-hookshot/latest/setup/gitlab.html)
- [Jira](https://matrix-org.github.io/matrix-hookshot/latest/setup/jira.html)
- [RSS/Atom feeds](https://matrix-org.github.io/matrix-hookshot/latest/setup/feeds.html)
2019-08-07 18:56:50 +01:00
Get started by reading [the setup guide](https://matrix-org.github.io/matrix-hookshot/latest/setup.html)!
2019-08-07 18:56:50 +01:00
2021-12-01 18:01:19 +00:00
## Documentation
2022-03-02 18:16:04 +00:00
Documentation can be found on [GitHub Pages](https://matrix-org.github.io/matrix-hookshot).
2021-12-01 18:01:19 +00:00
You can build the documentation yourself by typing:
2021-12-01 18:01:19 +00:00
```sh
# cargo install mdbook
mdbook build
sensible-browser book/index.html
```
2019-08-07 18:56:50 +01:00
## Contact
We have a Matrix support room ([#hookshot:half-shot.uk](https://matrix.to/#/#hookshot:half-shot.uk)).