Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nrss(1) [debian man page]

NRSS(1) 							       NRSS								   NRSS(1)

NAME

       NRSS - An ncurses RSS reader

DESCRIPTION

       NRSS is an RSS reader built to use minimal amounts of external libraries, using a minimal interface while maintaining a featureful client.

COMMAND LINE USAGE

       -h     Simple help

       -v     Print version

       -c [num]
	      Set number of columns

       -D [path]
	      Set the configuration directory (default: ~/.nrss/)

       -C [path]
	      Set the configuration file (default: ~/.nrss/config)

       -F [path]
	      Set the feed directory (default: ~/.nrss/feeds)

       -L [path]
	      Set the log file (default: ~/.nrss/log)

INTERNAL USAGE

       Within the program you can use the following (default) keys.  These can be changed in your configuration file by using the "key" command.

       UP or DOWN
	      Select previous or next item/feed (next) (prev)

       PGUP or PGDOWN
	      Goto previous or next feed (next-feed) (prev-feed)

       h      Display usage (toggle-usage)

       C      Toggle collapse all feeds (toggle-collapse-all)

       Space  Collapse a feed or read a story (default)

       g      Use the defined browser to goto the item's URL (goto)

       x      Show all items in feed (toggle-expand)

       r      Refresh the current feed (refresh)

       R      Refresh all (refresh-all)

       M      Mark all read (mark-all-read)

       D      Redraw screen (redraw)

       q      Quit NRSS (quit)

CONFIGURATION

       The ~/.nrss/config file is where all of the configuration is. You can start by using the example config below.

EXAMPLE CONFIG

       default_rate "5"
       default_show "30"
       default_maxitems "50"

       #Add some feeds
       add "http://rss.slashdot.org/Slashdot/slashdot" "Slashdot"
       add "http://www.digg.com/rss/index.xml" "Digg All"
       add "http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml" "BBC"
       add "http://www.osnews.com/files/recent.xml" "OSNews"
       add "http://distrowatch.com/news/dw.xml" "DistroWatch"

       #Change rate for Slashdot
       rate "30" "Slashdot"

       #These aren't defaults, but examples
       browser "/usr/bin/elinks %u"

       #Text browsers should enable this
       browser_wait "1"

FILES

       ~/.nrss/config
	      Main configuration file. For advanced usage, see the online configuration documentation: http://codezen.org/nrss-config

       ~/.nrss/log
	      Everyday log file.

       ~/.nrss/feeds/
	      This is where the raw XML is stored.

BUGS

       None known, but it's not outside of the realm of possibility =P.

HOMEPAGE

       http://codezen.org/nrss

AUTHOR

       Jack Miller <jjm2n4@umr.edu>

Version 0.3.9							 26 February 2008							   NRSS(1)

Check Out this Related Man Page

Wiki::Toolkit::Plugin::RSS::Reader(3pm) 		User Contributed Perl Documentation		   Wiki::Toolkit::Plugin::RSS::Reader(3pm)

NAME

       Wiki::Toolkit::Plugin::RSS::Reader - retrieve RSS feeds for inclusion in Wiki::Toolkit nodes

DESCRIPTION

       Use this Wiki::Toolkit plugin to retrieve an RSS feed from a given URL so that you can include it in a wiki node.

SYNOPSIS

	   use Wiki::Toolkit::Plugin::RSS::Reader;

	   my $rss = Wiki::Toolkit::Plugin::RSS::Reader->new(
	     url   => 'http://example.com/feed.rss'
	   );

	   my @items = $rss->retrieve;

USAGE

       This is a plugin for Wiki::Toolkit, a toolkit for building wikis; therefore please consult the documentation for Wiki::Toolkit for relevant
       information.  This module can, however, be used standalone if you wish.

METHODS

   "new"
	   my $rss = Wiki::Toolkit::Plugin::RSS::Reader->new([options]);

       Create a new RSS reader. Valid options are "url" or "file" (a path to an RSS file); only one can be specified.

   "retrieve"
	   my @items = $rss->retrieve;

       "retrieve" will return an array of hashes, one for each item in the RSS feed. The hashes contain three items, "title", "link", and
       "description".

       If the URL or file you specified cannot be retrieved/read, "retrieve" will return undef rather than blowing up and surprising the person
       reading your wiki. If you want, you can specify "debug" to be 1 in the options to "new", which will cause the module to croak instead of
       failing silently.

AUTHOR

       Earle Martin (EMARTIN@cpan.org) The Wiki::Toolkit team, (http://www.wiki-toolkit.org/)

LEGAL

       Copyright 2004 Earle Martin.  Copyright 2006 the Wiki::Toolkit team.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2009-10-25				   Wiki::Toolkit::Plugin::RSS::Reader(3pm)
Man Page