---
name: "nrss"
section: "1"
platform: "linux"
package: "nrss"
version: "0.3.9-1+b2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/nrss"
---

# nrss(1)

An ncurses RSS reader

## 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\>