NEWSBEUTER(1)
===========
Andreas Krennmair <ak@synflood.at>


NAME
----
newsbeuter - an RSS feed reader for text terminals


SYNOPSIS
--------
'newsbeuter' [-r] [-e] [-i opmlfile] [-u urlfile] [-c cachefile] [-C configfile] [-v] [-o] [-x <command> ...] [-h]


DESCRIPTION
-----------
'newsbeuter' is an RSS feed reader for text terminals. RSS is a number of
widely-used XML formats to transmit, publish and syndicate articles, for
example news or blog articles.  Newsbeuter is designed to be used on text
terminals on Unix or Unix-like systems such as Linux, BSD or Mac OS X.


OPTIONS
-------
-h::
        Display help

-r::
        Refresh feeds on start

-e::
        Export feeds as OPML to stdout

-v::
        Clean up cache thoroughly (i.e. reduce it in size if possible)

-V::
        Get version information about newsbeuter and the libraries it uses

-i opmlfile::
       Import an OPML file

-u urlfile::
       Use an alternative URL file

-c cachefile::
       Use an alternative cache file

-C configfile::
       Use an alternative configuration file

-x command ...::
       Execute one or more commands to run newsbeuter unattended. Currently available
       commands are "reload" and "print-unread".

-o::
       Active offline reading mode. When bloglines synchronization mode is configured,
       then the list of feeds will not be loaded from bloglines.com, but instead from
       the local cache. This makes it possible to read locally cached articles even
       without internet connection to connect to the bloglines server.

FIRST STEPS
-----------

include::chapter-firststeps.txt[]

CONFIGURATION COMMANDS
----------------------

include::newsbeuter-cfgcmds.txt[]


TAGGING
-------

include::chapter-tagging.txt[]


SCRIPTS AND FILTERS
-------------------

include::chapter-snownews.txt[]


COMMAND LINE
------------

include::chapter-cmdline.txt[]

'quit'::
        Quit newsbeuter

'save' <filename>::
        Save current article to <filename>

'set' <variable>[=<value>]::
        Set (or get) configuration variable value

'tag' <tagname>::
        Select a certain tag

'goto' <case-insensitive substring>::
        Go to the next feed whose name contains the case-insensitive substring.

'<number>'::
        Jump to the <number>th entry in the current dialog


FILES
-----

'$HOME/.newsbeuter/config'

'$HOME/.newsbeuter/urls'


SEE ALSO
--------
podbeuter(1). The documentation that comes with newsbeuter is a good
source about the general use and configuration of newsbeuter.


AUTHORS
-------
Andreas Krennmair <ak@synflood.at>, for contributors see AUTHORS file.


