Go to file
Marc Koch b6d4c24352 add custom exception 2024-07-04 16:39:37 +02:00
ntfy add custom exception 2024-07-04 16:39:37 +02:00
.gitignore Initial commit 2023-01-08 14:54:27 +01:00
.gitlab-ci.yml Change built output name 2023-01-08 15:15:14 +01:00
LICENSE Add license 2023-01-08 14:57:21 +01:00
README.md update README.md 2024-06-29 01:12:14 +02:00
base-config.yaml Only allow admins/privileged users to configure subscriptions 2023-01-08 15:05:01 +01:00
maubot.yaml bump version to 0.2.0 2024-06-29 01:12:38 +02:00

README.md

maubot-ntfy

This is a maubot plugin to subscribe to ntfy topics and send messages to a matrix room.

Usage

Install as a maubot plugin and configure an instance. Until maubot supports installing python dependencies, you should install the emoji python package for full functionality. Alternatively, @ntfy:catgirl.cloud is available as well.

Commands

Command Example Description
!ntfy add-topic <server>/<topic> !ntfy add-topic ntfy.sh/my_topic Adds a topic to the database and makes it available globally within this bot instance.
!ntfy remove-topic <server>/<topic> !ntfy remove-topic ntfy.sh/my_topic Removes an available topic from the database and to cancels all associated subscriptions.
!ntfy list-topics Lists all available topics for this bot instance.
!ntfy subscribe <server>/<topic> !ntfy subscribe ntfy.sh/my_topic Subscribe the current room to the ntfy topic. Future messages will be sent to the room.
!ntfy subscribe <server>/<topic> <access_token> !ntfy subscribe ntfy.sh/my_protected_topic tk_be6uc2ca1x1orakcwg1j3hp0ylot6 Subscribes to a protected topic via access token.
!ntfy unsubscribe server/topic !ntfy subscribe ntfy.sh/my_topic Unsubscribes a room from a topic.
!ntfy list-subscriptions Lists all active subscriptions for this bot room.