Manpages

NAME

raggle − text mode RSS aggregator

SYNOPSIS

raggle [−ahlv] [−−add] [−−force] [−−help] [−−usage] [−−list] [−−verbose] [−−lock−title] [−−save−items] [−−server] [−−purge] [−−sort] [−−sort−feeds] [−−diag] [−−usage] [−−unsave−items] [−−unlock−title] [−−verbose] [−−version] [−c file] [−−config file] [−−config−file file] [−d feed] [−−delete feed] [−−delete−feed feed] [−e feed] [−−edit feed] [−−edit−feed feed] [−−export−opml file] [−−import−opml file] [−i feed] [−−invalidate feed] [−−invalidate−feed feed] [−r refresh_time] [−−refresh refresh_time] [−t title] [−−title title] [−u url] [−−url url]

DESCRIPTION

raggle is a curses based RSS aggregator.

The following options are available:
−h −−help −−usage

Show usage information.

−l −−list

List feeds

−v −−version

Show raggle version

−c file −−config file −−config−file file

Use file as an alternate configuration file.

−a −−add

Add a new feed. Requires −−url.

−−diag

Print out full stack traces, and other diagnostic information intended for bug hunting.

−d feed −−delete feed −−delete−feed feed

Delete feed from the feed list.

−e feed −−edit feed −−edit−feed feed

Edit feed’s information.

−−export−opml file

Export all feeds to file in OPML format.

−−force

Force and edit/addition to succeed even if it wants to do things that are generally unwise

−−import−opml file

Import feeds from an OPML format file

−i feed −−invalidate feed −−invalidate−feed feed

Invalidate feed (force it to be refreshed). If −1 is given as feed then all feeds are updated.

−−lock−title

Lock the title of a feed (blocks updating of a feeds title from data in the feed itself), used with −−add on −−edit.

−−purge

Purge deleted feeds from the feed cache

−r refresh_time −−refresh refresh_time

Set a feeds refresh time to refresh_time, used with −−add on −−edit

−−save−items

Save old items from a feed, used with −−add or −−edit

−−server

Run Raggle in HTTP server mode.

−−sort −−sort−feeds

Sort feed list alphabetically by title.

−t title −−title title

Set a feed’s title to title, used with −−add or −−edit

−−unlock−title

Reverse the actions of −−unlock−title, cause it to be updated from the title stored in the RSS feed, used with −−add or −−edit

−−unsave−items

Reverse the actions of −−save−items, cause old items to be removed from the feed cache, used with −−add or −−edit

−u url −−url url

Set the URL to retrieve a feed from to url, used with −−add or −−edit

KEYS

Right Arrow

Move to the next window.

Left Arrow

Move to the previous window.

F12, q

Quit raggle

Up Arrow

Scroll up.

Down Arrow

Scroll down.

PageUp

Scroll up one page.

PageDown

Scroll down one page.

Return, Space

Select Item.

Delete

Delete item.

EXAMPLES

Add a feed called "Bar" updating every 2 hours.
$ raggle −−add −t "Bar" −u "http://foo.com/bar.rss"; −r 120

Change the refresh time of the "Bar" feed to update every hour.
$ raggle −−edit 1 −−refresh 60

Tell raggle not to update feed #1’s title from the RSS
$ raggle −−edit 1 −−lock−title

Tell raggle to keep old items associated with feed #16
$ raggle −−edit 16 −−save−items

Tell raggle to update feed #1’s title from the RSS info.
$ raggle −−edit 1 −−unlock--title

Change the URL of the 3rd feed.
$ raggle −−edit 3 −−url http://www.slashdot.org/slashdot.rss

Export all feeds to foo.opml
$ raggle −−export−opml foo.opml

Import all feeds from foo.opml, so that their refresh time is set to 90 minutes.
$ raggle −−import−opml foo.opml −−refresh 90

BUGS

HISTORY

raggle 0.1 was released on 23 Jun, 2003
raggle 0.2 was released on 17 Aug, 2003

AUTHORS

Paul Duncan <pabs [AT] pablotron.org>,
Richard Lowe <richlowe [AT] richlowe.net>,
Ville Aine <vaine [AT] cs.fi>