rf man page

rf — read feeds from any source

Synopsis

rf [OPTIONS] [FEED]

Example: rf linux

Description

read feed is a command that reads feeds from any source. read feed uses the feed of a site to manage it with a command line interface.

Mandatory arguments for long options are mandatory for short options too.

-l, --list

list the available feeds

-t, --title[=ITEMS]

set the title mode (default)

-d, --description=ITEM

set the description mode

-n, --link=ITEM

set the link mode

-c, --cache=MINUTES

set the cache time

-h, --help

show a help message

-v, --version

show the program version

On no config creates ~/.rf directory and adds the default feeds to the ~/.rf/feeds file (rf_rss_feeds=( ["name"]="url" ["name"]="url" ). rf_atom_feeds=( ... )).

With no option, use title mode. With no items, show all. With no cache time, use 30 minutes.

Examples

1: Configuring
$ rf
rf: feed not specified
Try `rf --help' for more information.
then
$ $EDITOR ~/.rf/feeds
2: Listing feeds:
$ rf --list
debian-people
debian-planet
fedora-people
fedora-planet
foss-people
freecode
freedesktop-people
freedesktop-planet
freegamedev-planet
freegame-people
freegame-planet
gimp
gnome
gnome-blogs
gnome-devel
gnome-people
gnome-planet
gstreamer
gstreamer-people
gstreamer-planet
gtk
jabber-people
jabber-planet
kde
kde-people
linux
linux-journal
linux-magazine
linux-today
lwn
mozilla-people
mozilla-planet
phoronix
python-people
slashdot
3: Showing titles of feed:
$ rf linux
[1] How Google Compute Engine Hopes to Sidestep AWS Failures
[2] China Takeover as Tech Innovation Center Inevitable
[3] Why a 32GB Nexus 7 is Almost Inevitable
[4] 30 Linux Kernel Developers in 30 Weeks: Paul Mundt
[5] Development Release: Frugalware Linux 1.7 RC1
[6] Intel 2.20.1 X.Org Driver Closes Critical Bugs
[7] Samsung Sacrificed Qualcomm Truce for Apple War
[8] Arch Linux 2012.07.15 Drops AIF
[9] Research: Samsung Has Sold 10M Galaxy S3′s, But ‘iPhone 5′ Still The Most-Wanted Phone
[10] Facebook, Last.fm and Pals to Reach Deep Into Ubuntu
[11] Linux Mint 13 “KDE” Released
[12] Intel and Valve Collaborate to Develop Open Source Graphics Drivers
3: Showing description of a feed item:
$ rf linux --description 12
Intel and Valve are collaborating to optimise the open source graphics drivers and the game engine used by the upcoming Linux port of first-person shooter game Left 4 Dead 2... 

Notes

The feeds file is just an associative bash array with an structure like ["feed"]="link".

rf_rss_feeds=(

	# Linux 
	["slashdot"]="http://rss.slashdot.org/Slashdot/slashdot/to"
	["phoronix"]="http://www.phoronix.com/rss.php"
	["foss-people"]="http://fossplanet.osdir.com/backend.php"
	["freegame-people"]="http://planet.freegamedev.net/rss20.xml"
	["freedesktop-people"]="http://planet.freedesktop.org/rss20.xml"
	["linux-journal"]="http://www.linuxjournal.com/node/feed"
	["linux-magazine"]="http://www.linux-magazine.com/rss/feed/lmi_full"
	["linux-today"]="http://feedproxy.google.com/linuxtoday/linux"
	["lwn"]="http://lwn.net/headlines/newrss"
	["mozilla-people"]="http://planet.mozilla.org/rss20.xml"
	["jabber-people"]="http://planet.jabber.org/rss20.xml"
	["python-people"]="http://planet.python.org/rss20.xml"
	["fedora-people"]="http://planet.fedoraproject.org/rss20.xml"
	["debian-people"]="http://planet.debian.org/rss20.xml"

	# KDE:
	["kde-people"]="http://planetkde.org/rss20.xml"
	["kde"]="http://dot.kde.org/rss.xml"

	# GNOME: https://news.gnome.org/feeds.html
	["gnome-people"]="https://planet.gnome.org/rss20.xml"
	["gnome"]="http://www.gnome.org/feed/"
	["gnome-blogs"]="http://blogs.gnome.org/feed/"
	["gnome-devel"]="http://rss.gmane.org/messages/complete/gmane.comp.gnome.devel.announce"
	["gstreamer-people"]="http://gstreamer.freedesktop.org/planet/rss20.xml"
	["gstreamer"]="http://gstreamer.freedesktop.org/news/rss-1.0.xml"
	["gimp"]="http://www.gimp.org/news.rdf"
	["gtk"]="http://blogs.gnome.org/gtk/feed/"

	# Spanish
	#["barrapunto"]="http://barrapunto.com/barrapunto.rss"
	#["20-minutos"]="http://www.20minutos.es/rss/"
	#["20-minutos-tech"]="http://www.20minutos.es/rss/tecnologia/"
)

rf_atom_feeds=(

	# Linux
	["freegame-planet"]="http://planet.freegamedev.net/atom.xml"
	["freegamedev-planet"]="http://planetdev.freegamedev.net/atom.xml"
	["freecode"]="http://freecode.com/?format=atom"
	["freedesktop-planet"]="http://planet.freedesktop.org/atom.xml"
	["gnome-planet"]="https://planet.gnome.org/atom.xml"
	["linux"]="https://www.linux.com/feeds/all-content"
	["gstreamer-planet"]="http://gstreamer.freedesktop.org/planet/atom.xml"
	["mozilla-planet"]="http://planet.mozilla.org/atom.xml"
	["jabber-planet"]="http://planet.jabber.org/atom.xml"
	["fedora-planet"]="http://planet.fedoraproject.org/atom.xml"
	["debian-planet"]="http://planet.debian.org/atom.xml"

)

Check rf-gnome for an automatic release mailer example.

Author

Written by Juan Manuel Borges Caño.

Homepage

rf (read feed) home page <http://code.google.com/p/readfeed>.

Reporting Bugs

Report bugs to <juanmabcmail@gmail.com>.

See Also

The full documentation for rf is maintained as a Texinfo manual.  If the info and rf programs are properly installed at your site, the command

info rf

should give you access to the complete manual.

Info

February 2017 rf 0.4.18 User Commands