From a5e57a8aff64edbdc9adf74bfb29cd795541c99e Mon Sep 17 00:00:00 2001 From: lead2gold Date: Sun, 27 Jan 2019 11:00:26 -0500 Subject: [PATCH] Created Notify_matrix (markdown) --- Notify_matrix.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 Notify_matrix.md diff --git a/Notify_matrix.md b/Notify_matrix.md new file mode 100644 index 0000000..caca310 --- /dev/null +++ b/Notify_matrix.md @@ -0,0 +1,31 @@ +## Matrix Notifications +* **Source**: https://matrix.org/ +* **Icon Support**: No +* **Message Format**: Text +* **Message Limit**: 1000 Characters per message + +To use this plugin, you need to first set yourself up with https://matrix.org. + +### Syntax +Valid syntaxes are as follows: +* **matrix**://**{token}** +* **matrix**://**{token}**?**mode=slack** +* **matrix**://**{user}**@**{token}**?**mode=slack** + +Both **matrix://** and **matrixs://** are both handled in a secure fashion. + +### Parameter Breakdown +| Variable | Required | Description +| ----------- | -------- | ----------- +| token | Yes | The token you would have gotten after setting up the matrix.org +| user | No | The user to associate with the webhook created on matrix.org. By default, this is set to **apprise** +| port | No | The server port Matrix is listening on. By default the port is **443**. + +#### Example +Send a secure Matrix.org notification to our server +```bash +# Assuming our {token} is 3ccdd113474722377935511fc85d3dd4 +# Assuming our {user} is caronc + +apprise matrix://caronc@3ccdd113474722377935511fc85d3dd4 +``` \ No newline at end of file