Kumi
d8455ca1d3
Introduce the ability for users to override the default event type on a per-room basis in the Matrix RSS bot. By adding a new `eventtype` command and updating the help menu to include this command, users can now specify whether messages in a particular room should be sent as "text" or "notice". This feature provides greater flexibility and customization for room administrators, catering to diverse notification preferences and use cases. The implementation does not validate the event type beyond checking for "text" or "notice", ensuring simplicity in usage while relying on user input accuracy. This change enhances the bot's versatility in different Matrix environments, allowing for more refined control over how feed updates are communicated within rooms. |
||
|---|---|---|
| .github | ||
| contrib | ||
| src/matrix_rssbot | ||
| .gitignore | ||
| config.dist.ini | ||
| LICENSE | ||
| pantalaimon_first_login.py | ||
| pyproject.toml | ||
| README.md | ||
| rssbot.service | ||
Matrix-RSSBot
This is a simple, no-database RSS/Atom feed bot for Matrix. It is designed to be easy to use and lightweight.
Installation
pip install matrix-rssbot
Create a configuration file in config.ini based on the config.dist.ini provided in the repository.
At the very least, you need to provide the following configuration:
[Matrix]
Homeserver = http://your-homeserver.example.com
AccessToken = syt_YourAccessTokenHere
We recommend using pantalaimon as a proxy, because the bot itself does not support end-to-end encryption.
You can start the bot by running:
rssbot
Usage
The bot will automatically join all rooms it is invited to.
You have to ensure that the bot has the necessary permissions to send state events and messages in the room. Regular users cannot send state events, so you have to either raise the bot user's power level (Moderator level should do) or lower the power level required to send state events.
You can now add a feed to the bot by sending a message to the bot in the room you want the feed to be posted in. The message should be in the following format:
!rssbot addfeed https://example.com/feed.xml
To list all feeds in a room, you can use the following command:
!rssbot listfeeds
Finally, to remove a feed, you can use the following command:
!rssbot removefeed https://example.com/feed.xml
Alternatively, you can use the number of the feed in the list, which you can get by using the listfeeds command instead of the URL.
License
This project is licensed under the MIT License - see the LICENSE file for details.