2021-08-17 11:56:53 +08:00
# node-red-contrib-matrix-chat
2021-08-19 01:18:29 +08:00
Matrix chat server client for [Node-RED ](https://nodered.org/ )
***Currently we are in beta. We ask that you open any issues you have on our repository to help us reach a stable well tested version. Things may change & break before our first release so check changelog before updating.***
2021-08-14 23:00:57 +08:00
2021-08-17 11:56:53 +08:00
### Features
The following is supported from this package:
2021-08-24 00:17:08 +08:00
- End-to-end encryption supported
- Receive events from a room (messages, reactions, images, and files) whether encrypted or not
- Send Images/Files (sending files to e2ee room doesn't currently encrypt them yet)
- Decrypt files in e2ee rooms
2021-08-19 01:18:29 +08:00
- Send HTML/Plain Text Message/Notice
2021-08-17 11:56:53 +08:00
- React to messages
2021-08-19 01:18:29 +08:00
- Register user's on closed registration Synapse servers using `registration_shared_secret` (Admin Only)
- List out users on a Synapse server (Admin Only)
- Get WhoIs info for a Synapse user (Admin Only)
- Add/Edit Synapse users using the v2 API (requires a pre-existing admin account)
2021-08-24 00:17:08 +08:00
- Deactivate users on Synapse servers (Admin Only)
2021-08-19 01:18:29 +08:00
- Get a user list from a room
- Kick user from room
- Ban user from room
2021-08-24 00:17:08 +08:00
- Join a room
- Create a room
- Invite to a room
- Synapse admin API to force add user to room (requires bot to be in same room already)
2021-08-19 01:18:29 +08:00
2021-08-17 11:56:53 +08:00
2021-08-19 01:18:29 +08:00
Therefore, you can easily build a bot, chat relay, or administrate your Matrix server from within [Node-RED ](https://nodered.org/ ).
2021-08-17 11:56:53 +08:00
2021-08-19 04:19:20 +08:00
### Examples
We have examples! [Check them out ](examples )
2021-08-17 11:56:53 +08:00
### Installing
You can either install from within Node-RED by searching for `node-red-contrib-matrix-chat` or run this from within your Node-RED directory:
```bash
npm install node-red-contrib-matrix-chat
```
### Usage
Using this package is very straightforward. Examples coming soon!
### Other Packages
- [node-red-contrib-gamedig ](https://www.npmjs.com/package/node-red-contrib-gamedig ) - Query game servers from Node-RED!
### Contributing
All contributions are welcome! If you do add a feature please do a pull request so that everyone benefits :)
Sharing is caring.