RAGGLE(1)

NAME
raggle - Console RSS aggregator.

SYNOPSIS
raggle [-aAhlvV] [--add [url]] [--ascii] [--default-config] [--diag] [--force] [--help] [--list] [--lock-title] [--purge] [--save-items] [--server [port]] [--sort] [--unlock-title] [--unsave-items] [--usage] [--verbose] [--version] [-c file] [--config file] [-d feed] [--delete feed] [-e feed] [--edit feed] [--export-opml file] [-f string] [--find-feeds string] [--import-opml file/uri] [-i feed] [--invalidate feed] [--max num] [-p priority] [--priority priority] [-r refresh_time] [--refresh refresh_time] [-t title] [--title title] [-u url] [--url url] [--U feed] [--update feed]

DESCRIPTION
raggle is a curses-based RSS aggregator.

The following options are available:

-a [url]  --add [url]
    Add a new feed. You can optionally specify url, otherwise it requires --url.

-A  --ascii
    Use ASCII graphics for windows.

-c file  --config file
    Use file as an alternate configuration file.

-d feed  --delete feed
    Delete feed from the feed list.

--default-config
    Print out the default configuration of Raggle in a format suitable for your config.rb file.

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

-e feed  --edit feed
    Edit feed's information.

--export-opml file
    Export all feeds to file in OPML format.

-f string  --find string
    Find a feed containing string (uses Syndic8).

--force
    Force an edit/addition to succeed even if it wants to do things that are generally unwise.

-h  --help  --usage
    Show usage information.

--import-opml file/uri
    Import feeds from an OPML format file or uri.

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

-l  --list
    List current feeds. Use -v or --verbose to display extra info.

--lock-title
    Lock the title of a feed (blocks updating of a feed's title from data in the feed itself), used with --add or --edit.

--max num
    Set the maximum number of items in a feed to num. Automatically sets --save-items.

-p priority  --priority priority
    Set the feed priority to priority. 0 is the default, higher values will sort a feed closer to the top.

--purge
    Purge deleted feeds from the feed cache.

-r refresh_time  --refresh refresh_time
    Set a feed's refresh time to refresh_time; used with --add or --edit.

--save-items
    Save all old items from a feed rather than replacing them with newly fetched ones; used with --add or --edit.

--server [port]
    Run Raggle in HTTP server mode, optionally specifying a port.

--sort
    Sort feed list by priority then by title, case-insensitive.

-t title  --title title
    Set a feed's title to title, used with --add or --edit.

--unlock-title
    Reverse the actions of --lock-title, causing 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 feed  --update feed
    Update the specified feed (or all for all feeds).

-u url  --url url
    Set the URL from which to retrieve a feed to url, used with --add or --edit.

-v  --verbose
    Turns on verbose output, displaying extra info on the command line.

-V  --version
    Show raggle version.

KEYS: MOTION

F12, q
    Quit raggle

Right Arrow, Tab, l
    Move to the next window.

Left Arrow, h
    Move to the previous window.

Up Arrow, k
    Scroll up.

Down Arrow, j
    Scroll down.

End, $, G
    Scroll to bottom.

Home, 0, g
    Scroll to top.

PageUp
    Scroll up one page.

PageDown
    Scroll down one page.

KEYS: INTERACTION

Return, Space
    Select item.

o   Open the current feed or item's link in your browser.

1 through 9
    Open a link from the current story in your browser. Link numbers are given at the bottom of the description window.

u   Move item up.

d   Move item down.

a   Add a feed. Will add the currently selected feed after a search via f, otherwise you will be prompted for the address.

O   Import or export an OPML copy of your feed list. If the given name is an existing file or a URI, it will be imported; otherwise, a new OPML file will be created with the given name.

e   Edit the current feed's options to your liking.

I   Invalidate the current feed, causing a refresh.

Delete
    Delete feed or item.

y   Undelete all items in the current feed.

/   Find an entry.

f   Search for a feed via Syndic8.

p   Select previous unread item.

n   Select next unread item.

m   Mark all items as read.

M   Mark all items as unread.

N   Mark current item as unread.

s   Sort list.

r   Lower the current feed's sorting priority.

R   Raise the current feed's sorting priority.

c   Select a feed category to view.

C   Close the current window.

KEYS: SYSTEM

!   Run a shell in the foreground (exit from it to get back to raggle)

?   Show current key bindings.

\   View item source.

U   Start a manual update of feeds.

S   Start a manual save of feeds and configuration.

C-l Redraw the screen.

EXAMPLES
Add a feed called "Bar" updating every 2 hours.
    $ raggle --add -t Bar --url http://foo.com/bar.rss --refresh 120

Add a feed called "Baz" that will sort to the top.
    $ raggle -a -t "Baz" -u http://foo.com/baz.rss --priority 10

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

Don't update feed #1's title from the RSS.
    $ raggle -e 1 --lock-title

Keep old items associated with feed #16.
    $ raggle -e 16 --save-items

Update feed #1's title from the RSS info.
    $ raggle -e 1 --unlock-title

Change the URL of feed #3.
    $ raggle -e 3 -u http://www.slashdot.org/slashdot.rss

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

Import all feeds from foo.opml, and set their refresh time to 90 minutes.
    $ raggle --import-opml foo.opml -r 90

Import all feeds from foo.opml, and set their refresh time to 90 minutes.
    $ raggle --import-opml foo.opml -r 90

Find feed matching the string "halffull"
    $ raggle --find halffull

ENVIRONMENT

BROWSER
    Used to find a suitable web browser (see RAGGLE_BROWSER).

HOME
    Used to find the Raggle configuration directory.

http_proxy
    HTTP Proxy server, in the format "http://host:port/".

no_proxy
    Comma-delimited list of hosts and domains to connect directly to (only applicable if you're using an HTTP proxy).

PATH
    Used to find a suitable web browser (see RAGGLE_BROWSER).

RAGGLE_BROWSER
    Path to the web browser Raggle should use when a feed item is opened. If RAGGLE_BROWSER isn't set, Raggle checks BROWSER, then looks for common command-line browsers in PATH. Note: this behavior can be overridden by setting the 'browser' config directive in your Raggle configuration file.

RAGGLE_WEB_DATA
    Used to find the web interface data files. If it's not set, Raggle looks for a directory called "web_ui" in the configuration directory.

SHELL
    Shell to launch when invoking a sub-shell.

WINDOW
    Used to determine if Raggle is running in screen.

BUGS

*   Pressing Ctrl-C while adding a feed will cause Raggle to exit unexpectedly, not cancel.

*   It's possible that feeds.yaml will be mistakenly written as an Array rather than a FeedList for no apparent reason.

*   Possibly more! Please report any you find to <raggle-dev@raggle.org>

HISTORY

raggle 0.1 was released on 23 Jun, 2003
raggle 0.2 was released on 17 Aug, 2003
raggle 0.3 was released on 20 Feb, 2004
raggle 0.4 was released on 15 Mar, 2005

AUTHORS

Paul Duncan <pabs@pablotron.org>,
Richard Lowe <richlowe@richlowe.net>,
Ville Aine <vaine@cs.helsinki.fi>,
Thomas Kirchner <redshift@halffull.org>