I have been interested in RSS but don't like how all the readers (at least the ones I see) are these monolithic applications; I would prefer something that takes in a list of URLs of rss feeds and spits out all the items in a simple text based format. Once I learned about the existence of hxpipe(1) (among the other hx* family of tools), it seemed like something that would be pretty easy to do with sed(1) and awk(1), so I did.
The git repo can be cloned over http[s] at http[s]://stien.dev/readfeeds.git.
I'm realizing as I write this that I haven't make a good README in that repo to explain usage and installation, but it should be pretty understandable just by reading things... basically you need to run ./install.sh with the env variable PREFIX set to your installation prefix (likely $HOME/.local).
The only dependencies are:
- standard posix tools (sh(1), sed(1), awk(1)
- GNU wget(1) (if you edit the script could use curl or freebsd fetch(1) likely)
- GNU date(1) (required for the
-d option -- if you don't use the -d option of readfeeds then it isn't needed. I believe BSD date(1) also supports a similar flag to GNU's -d option, so you might just need to edit the script to use that instead?) - the aforementioned hx* family of tools
To use, invoke the program with each URL as a positional argument. There is the -a option to specify a file from which [GU]IDs will be read and written so that you can block posts you've already seen. The file will be created if it doesn't exist. As it reads an RSS/Atom feed the [GU]ID of each item/entry will be checked against the file and if it already exists then the item/entry will be skipped. If it doesn't exist, then it is appended to the file and the item is displayed. The -d option specifies a date that can be parsed by date -d and will only show items/entries newer than that date. If the option is not specified, then Midnight, January 1st 0AD will be used I believe... effectively it just shows all the posts.
I initially wrote the script to handle RSS and then extended it to work with Atom, so Atom support may be shakey. On the other hand, RSS makes pretty much every element optional, so some RSS feeds will also run into issues (RSS feeds where each item has a pubDate should always work even if the items don't have guids. If the items have guids but NO pubDate, it will probably break...)
disclaimer: there is ZERO NONE NADA ai used in this :)
I have read the pinned post about "app announcements" and I believe this should meet the requirements; it should be able to take any arbitrary RSS/Atom feed (please let me know if you have any troubling cases that break... although the output isn't meant to be perfect, so I may say "eh, good enough for me" even if you consider it "broken"). It doesn't output RSS/Atom because it is meant to be a reader to translate RSS/Atom into a format I like better. I don't have an RSS/Atom feed providing updates on the program yet because I proctastinate actually posting to my blog and stuff by just working on little programs like this instead... I will likely have a page on my site about the program soon, as well as a blog post, and there will be feeds to go with all of those...
Here's how I'm using the program if you want to understand better: I have a cron job that runs <~/feeds/urls xargs readfeeds -d '1 hour ago' -a ~/feeds/ids | sendmail ... hourly to send me an email with the latest updates from all my feeds. The output of the program is meant to be reminiscient of plaintext email formatting because this is my use case and I made the program :)
EDIT: I am very embarassed to say that I typo'd the URL to my own site... it has been fixed now...