rss

rss
Login

RSS reader for the command line

Goal

A featureless rss reader, with a single goal in mind:

Download

Clone this repository using fossil:

$ fossil clone https://foutaise.org/fossil/rss rss.fossil
$ mkdir rss
$ cd rss
$ fossil open ../rss.fossil

Usage

$ rss -h
RSS reader for the command line
Usage: rss [options]
Options:
        -l            : list feeds
        -a <feedlink> : add feed
        -d <feedlink> : delete feed
        -b            : browse unread items
        -f            : flush unread items as read
        -r            : refresh items

Example

Add a feed

$ rss -a https://emacs.cafe/feed.xml

List available feeds

$ rss -l
[
	{
		"title": "Emacs café",
		"description": "A blog about Emacs, mostly focused on JavaScript development, by Nicolas Petton.",
		"link": "https://emacs.cafe/",
		"feedlink": "https://emacs.cafe/feed.xml"
	}
]

Refresh rss items

Update items from rss feeds, then list unread items:

$ rss -r
[
	{
		"title": "Introducing Elbank",
		"description": "Elbank is a new Emacs package I’ve been working on lately. It’s a personal finances and budgeting package for Emacs that uses Weboob for scraping data from bank websites.",
		"published": "2017-11-30T14:28:00+01:00",
		"guid": "https://emacs.cafe/elbank/emacs/2017/11/30/elbank-intro",
		"link": "https://emacs.cafe/elbank/emacs/2017/11/30/elbank-intro.html"
	},
	{
		"title": "beginend.el",
		"description": "Thank you Nicolas for letting me borrow (again) your blog to talk about my work. This time, this will not only be my work, but the one of Matus Goljer too (aka Fuco1). Let me present beginend.",
		"published": "2017-08-01T10:38:00+02:00",
		"guid": "https://emacs.cafe/emacs/package/2017/08/01/beginend",
		"link": "https://emacs.cafe/emacs/package/2017/08/01/beginend.html"
	},
	{
		"title": "Indium 0.7 is out!",
		"description": "Indium – the JavaScript development environment for Emacs – version 0.7 was released a few days ago!",
		"published": "2017-07-24T13:40:00+02:00",
		"guid": "https://emacs.cafe/indium/emacs/javascript/2017/07/24/indium-0.7-released",
		"link": "https://emacs.cafe/indium/emacs/javascript/2017/07/24/indium-0.7-released.html"
	},
...
]

Browse unread items

$ rss -b

Unread items are opened in the browser

Flush unread items as read

$ rss -f

Mark every unread item as read.

Combine flags

Flags can be combined in order to refresh/browse/flush items:

$ rss -r -b -f