Notify webhook of new posts in Simple Machines Forum instance
3a9c62bb — Jochen Kupperschmidt 7 months ago
Release version 0.5.0
2a60ad34 — Jochen Kupperschmidt 7 months ago
Add test step to build action
b3df08f7 — Jochen Kupperschmidt 7 months ago
Add test for config parsing



You can also use your local clone with git send-email.


Announce new threads and posts in a Simple Machines Forum instance by sending HTTP requests to a configurable webhook endpoint.


SMFNotify is intended to be invoked regularly, for example every few minutes (depending on the activity of the monitored forum and how quickly people want to be informed about new posts).

Each invocation fetches the feed, looks for new entries, and calls the webhook for each one before exiting.

A configuration file is mandatory to run it:

$ smfnotify --config config_example.toml

An example configuration file is included as config_example.toml and looks like this:

feed_url = "https://forum.example.com/index.php?action=.xml;type=atom"
feed_cookie_value = "<insert value of your 'SMFCookie10' cookie>"
feed_max_new_entries = 5

last_processed_id_filename = "last_processed_id"

webhook_text_template = "{author} posted to forum: \"{title}\" - <{url}>"
webhook_url = "<your-webhook-path>"

interval_in_seconds = 120

To obtain the cookie value, log in to the forum, then use your web browser's debugger or an extension to look up the cookie named SMFCookie10.

The interval is optional. If it is not set, SMFNotify will only fetch and potentially notify about new entries just once, then exit.


Both a Dockerfile and a compose.yaml are included to support running SMFNotify with Docker and Docker Compose.

Be sure to provide:

  • a configuration file named config.toml (and configure an interval) and
  • a last_processed_id file (can be empty; create with touch last_processed_id)

to avoid issues.


SMFNotify is a port of a Python script I wrote in October 2015.


SMFNotify is licensed under the MIT license.

Copyright 2022-2023 Jochen Kupperschmidt