rss-notifier

💬 Send RSS update notifications to Slack

Docker

docker run omrilotan/rss-notifier -- --interval 10 --webhook https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX --channel "#notifications-channel" --feeds https://www.githubstatus.com/history.rss,https://status.docker.com/pages/533c6539221ae15e3f000031/rss --log-level debug

NPX

npx rss-notifier --interval 10 --webhook https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX --channel "#notifications-channel" --feeds https://www.githubstatus.com/history.rss,https://status.docker.com/pages/533c6539221ae15e3f000031/rss --log-level debug

Docker with env vars

docker run -e INTERVAL=10 -e WEBHOOK=https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX -e CHANNEL="#notifications-channel" -e FEEDS=https://www.githubstatus.com/history.rss,https://status.docker.com/ ages/533c6539221ae15e3f000031/rss -e LOG-LEVEL=debug omrilotan/rss-notifier

or

export INTERVAL=10
export WEBHOOK=https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX
export CHANNEL="#notifications-channel"
export FEEDS=https://www.githubstatus.com/history.rss,https://status.docker.com/pages/533c6539221ae15e3f000031/rss
export LOG-LEVEL=debug

docker run -e INTERVAL -e WEBHOOK -e CHANNEL -e FEEDS -e LOG-LEVEL omrilotan/rss-notifier

and so on

CLI options

Name	Config File	Env Var	Type	Default
webhook	webhook	WEBHOOK	Webhook address	✘
feeds	feeds	FEEDS	Comma separated URLs	✘
interval	interval	INTERVAL	Minutes	Fifteen minutes
channel	channel	CHANNEL	Webhook channel	Default webhook channel
emoji	emoji	EMOJI	Slack emoji	:rolled_up_newspaper: ( 🗞 )
dry-run	dryRun	N/A	Boolean	no
log-level	N/A	LOG_LEVEL	debug, verbose, info, warn, error, critical	warn
log-format	N/A	LOG_FORMAT	plain, json	plain
config	N/A	CONFIG	Config file	None

Options preference order is: CLI argument (1st), Config File (2nd), Environment variable (3rd), default (where applicable)

Some options can not be configured in config file

How To Use

Interval

Run this as scheduled task, specify the interval in which you run it.

Examples:

If you are running a cron as */15 * * * * (each 15 minutes), set the interval argument to 15.

If you are running a cron as 0 9 */1 * * (every day at 09:00), set the interval argument to 1440 (60 * 24).

Feed(s)

The feed(s) is a list of one or more URLs.

Example:

If you want to "subscribe" to GitHub and Docker statuses set your feeds to both --feeds https://www.githubstatus.com/history.rss,https://status.docker.com/pages/533c6539221ae15e3f000031/rss

Yaml configuration

interval: 10
webhook: https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX
channel: "#notifications-channel"
feeds:
  - https://www.cloudflarestatus.com/history.atom
  - https://www.githubstatus.com/history.rss

Feed filter

You can add a filter to the feed. Only items including this substring in their title or content will be sent. Filters are case insensitive.

feeds:
  - https://www.cloudflarestatus.com/history.atom:
      include:
        - DNS

feeds:
  - https://www.cloudflarestatus.com/history.atom:
      exclude:
        - WARP