rss-watch is a command-line utillity for watching RSS/Atom feeds and executing a script whenever there's a new entry on the given feed.

Data about the entry is passed as environment variables to the script.

rss-watch creates a SQLite database to keep track of previously seen feeds and entries.

If you don't override the database path using the -d flag, the following default location will be used, depending on your platform.

You may want to run rss-watch with --import-only the first time you're watching a new feed, as this will import the current feed entries without running the scripts.

rss-watch --import-only https://blog.rust-lang.org/feed.xml

Then, to watch and refresh a feed every 6 hours and execute ./some-script.sh for each new entry, run:

rss-watch -r 6h https://blog.rust-lang.org/feed.xml ./some-script.sh

Create the file publish-redis-message.sh with the following contents:

#!/usr/bin/env bash

redis-cli publish some.channel "There's a new commit: ${FEED_LINK}"

Make it executable:

chmod +x ./publish-redis-message.sh

And run rss-watch with

rss-watch -r 1m https://github.com/mkroman/rss-watch/commits/master.atom ./publish-redis-message.sh

And it'll now check for new commits once a minute and publish the commit url to the channel some.channel.

This is a list of the environment variables that can be passed to the script.

Prerequisites:

• libsqlite3-dev

rss-watch is currently only available from crates.io or GitHub.

cargo install rss-watch

cargo install --git https://github.com/mkroman/rss-watch.git rss-watch

This software is licensed under the BSD 2-clause License.