RAGGLE(1)             User Contributed Perl Documentation            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>



perl v5.8.7                       2005-12-10                         RAGGLE(1)
