A very simple bash script that can be used to send a message to a Matrix room. Probably broken in ways that I have not experienced
Find a file
Bruno BELANYI bad1c90d39
All checks were successful
continuous-integration/drone/push Build is passing
ci: add Drone CI
This is my first experiment to make sure I can actually use this in my
CI.
2021-06-12 19:19:35 +02:00
.drone.yml ci: add Drone CI 2021-06-12 19:19:35 +02:00
.envrc nix: evaluate shell hooks 2021-06-12 00:39:58 +02:00
.gitignore git: ignore generated pre-commit configuration 2021-06-12 00:39:42 +02:00
flake.lock nix: add flake 2021-06-12 00:39:22 +02:00
flake.nix nix: add app and package to flake 2021-06-12 01:12:31 +02:00
matrix-notifier matrix-notifier: use 'auto' default message type 2021-06-12 19:19:26 +02:00
README.md doc: add README 2021-06-12 01:25:04 +02:00

matrix-notifier

This is a simple to send a message to a Matrix room. It automatically logs in and sends the message when invoked. This was written to be used a notification script in my CI/CD pipelines.

How to use

You need to define the following environment variables for the script to be executed correctly:

  • USER: the user to login as.
  • PASS: the password to login with.
  • ADDRESS: the address of the homeserver to connect to.
  • ROOM: the room id, as can be found in the room parameters.
  • MESSAGE: the message you wish to send to the room.

Example

export ADDRESS='https://matrix.org'
export USER='username'
export PASS='password'
export ROOM='!aaaaaaaaaaaaaaaaaa:matrix.org'
export MESSAGE='This is my test message'
./matrix-notifier

How to run/install

This script is packaged with Nix, you can just use nix run . to run it.

The only dependencies are bash, curl, and jq, install those and you should be ready to go!