NEWSBEUTER(1) | NEWSBEUTER(1) |
NAME¶
newsbeuter - an RSS feed reader for text terminalsSYNOPSIS¶
newsbeuter [-r] [-e] [-i opmlfile] [-u urlfile] [-c cachefile] [-C configfile] [-X] [-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¶
-hDisplay help
-r
Refresh feeds on start
-e
Export feeds as OPML to stdout
-X
Clean up cache thoroughly (i.e. reduce it in
size if possible)
-v, -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 Google
Reader synchronization mode is configured, then the list of feeds will not be
loaded from Google Reader, but instead from the local cache. This makes it
possible to read locally cached articles even without internet connection to
connect to Google Reader.
-l loglevel
Generate a loglevel with a certain loglevel.
Valid loglevels are 1 to 6. An actual logfile will only be written when you
provide a logfile name.
-d logfile
Use this logfile as output when logging debug
messages. Please note that this only works when providing a loglevel.
-E file
Export a list of read articles (resp. their
GUIDs). This can be used to transfer information about read articles between
different computers.
-I file
Import a list of read articles and mark them
as read if they are held in the cache. This is to be used in conjunction with
the -E commandline parameter.
FIRST STEPS¶
After you’ve installed newsbeuter, you can run it for the first time by typing "newsbeuter" on your command prompt. This will bring you the following message:Error: no URLs configured. Please fill the file /home/ak/.newsbeuter/urls with RSS feed URLs or import an OPML file.
newsbeuter 2.4 usage: ./newsbeuter [-i <file>|-e] [-u <urlfile>] [-c <cachefile>] [-x <command> ...] [-h] -e export OPML feed to stdout -r refresh feeds on start -i <file> import OPML file -u <urlfile> read RSS feed URLs from <urlfile> -c <cachefile> use <cachefile> as cache file -C <configfile> read configuration from <configfile> -X clean up cache thoroughly -x <command>... execute list of commands -o activate offline mode (only applies to Google Reader synchronization mode) -q quiet startup -v get version information -l <loglevel> write a log with a certain loglevel (valid values: 1 to 6) -d <logfile> use <logfile> as output log file -E <file> export list of read articles to <file> -I <file> import list of read articles from <file> -h this help
http://rss.cnn.com/rss/cnn_topstories.rss http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
CONFIGURATION COMMANDS¶
always-display-description (parameters: [true/false]; default value: false)If true, then the description will always
displayed even if e.g. a content:encoded tag has been found. (example:
always-display-description true)
always-download (parameters: <rssurl> [<rssurl>]; default
value: n/a)
The parameters of this configuration command
are one or more RSS URLs. These URLs will always get downloaded, regardless of
their Last-Modified timestamp and ETag header. (example: always-download
"http://www.n-tv.de/23.rss")
article-sort-order (parameters: <sortfield>[-<direction>];
default value: date)
The sortfield specifies which article property
shall be used for sorting (currently available: date, title, flags, author,
link, guid). The optional direction specifies the sort direction
("asc" specifies ascending sorting, "desc" specifies
descending sorting. for date, "desc" is default, for all others,
"asc" is default). (example: article-sort-order author-desc)
articlelist-format (parameters: <format>; default value:
"%4i %f %D %6L %?T?;%-17T; ?%t")
This variable defines the format of entries in
the article list. See the respective section in the documentation for more
information on format strings (note that the semicolon should actually be a
vertical bar; this is a limitation in AsciiDoc). (example: articlelist-format
"%4i %f %D %?T?;%-17T; ?%t")
auto-reload (parameters: [yes/no]; default value: no)
If enabled, all feeds will be automatically
reloaded at start up and then continuously after a certain time has passed
(see reload-time). (example: auto-reload yes)
bind-key (parameters: <key> <operation> [<dialog>];
default value: n/a)
Bind key <key> to <operation>.
This means that whenever <key> is pressed, then <operation> is
executed (if applicable in the current dialog). A list of available operations
can be found below. Optionally, you can specify a dialog. If you specify one,
the key binding will only be added to the specified dialog. Available dialogs
are "all" (default if none is specified), "feedlist",
"filebrowser", "help", "articlelist",
"article", "tagselection", "filterselection",
"urlview" and "podbeuter". (example: bind-key ^R
reload-all)
bookmark-cmd (parameters: <bookmark-command>; default value:
"")
If set, then <bookmark-command> will be
used as bookmarking plugin. See the documentation on bookmarking for further
information. (example: bookmark-cmd
"~/bin/delicious-bookmark.sh")
bookmark-interactive (parameters: [yes/no]; default value: no)
If set to yes, then the configured bookmark
command is an interactive program. (example: bookmark-interactive yes)
browser (parameters: <browser-command>; default value: lynx)
Set the browser command to use when opening an
article in the browser. If <browser-command> contains %u, it will be
used as complete commandline and %u will be replaced with the URL that shall
be opened. (example: browser "w3m %u")
cache-file (parameters: <path>; default value:
"~/.newsbeuter/cache.db")
This configuration option sets the cache file.
This is especially useful if the filesystem of your home directory
doesn’t support proper locking (e.g. NFS). (example: cache-file
"/tmp/testcache.db")
cleanup-on-quit (parameters: [yes/no]; default value: yes)
If yes, then the cache gets locked and
superfluous feeds and items are removed, such as feeds that can’t be
found in the urls configuration file anymore. (example: cleanup-on-quit
no)
color (parameters: <element> <fgcolor> <bgcolor>
[<attr> ...]; default value: n/a)
Set the foreground color, background color and
optional attributes for a certain element (example: color background white
black)
confirm-exit (parameters: [yes/no]; default value: no)
If set to yes, then newsbeuter will ask for
confirmation whether the user really wants to quit newsbeuter. (example:
confirm-exit yes)
cookie-cache (parameters: <file>; default value:
"")
Set a cookie cache. If set, then cookies will
be cached (i.e. read from and written to) in this file. (example: cookie-cache
"~/.newsbeuter/cookies.txt")
datetime-format (parameters: <date/time format>; default value:
%b %d)
This format specifies the date/time format in
the article list. For a detailed documentation on the allowed formats, consult
the manpage of strftime(3). (example: datetime-format "%D,
%R")
define-filter (parameters: <name> <filter>; default value:
n/a)
With this command, you can predefine filters,
which can you later select from a list, and which are then applied after
selection. This is especially useful for filters that you need often and you
don’t want to enter them every time you need them. (example:
define-filter "all feeds with fun tag" "tags #
\\"fun\\"")
display-article-progress (parameters: [yes/no]; default value:
yes)
If set to yes, then a read progress (in
percent) is displayed in the article view. Otherwise, no read progress is
displayed. (example: display-article-progress no)
download-retries (parameters: <number retries>; default value:
1)
How many times newsbeuter shall try to
successfully download a feed before giving up. This is an option to improve
the success of downloads on slow and shaky connections such as via a TOR
proxy. (example: download-retries 4)
download-full-page (parameters: [yes/no]; default value: no)
If set to yes, then for all feed items with no
content but with a link, the link is downloaded and the result used as content
instead. This may significantly increase the download times of
"empty" feeds. (example: download-full-page yes)
download-timeout (parameters: <seconds>; default value: 30)
The number of seconds newsbeuter shall wait
when downloading a feed before giving up. This is an option to improve the
success of downloads on slow and shaky connections such as via a TOR proxy.
(example: download-timeout 60)
error-log (parameters: <path>; default value: "")
If set, then user errors (e.g. errors
regarding defunct RSS feeds) will be logged to this file. (example: error-log
"~/.newsbeuter/error.log")
external-url-viewer (parameters: <command>; default value:
"")
If set, then "show-urls" will pipe
the current article to a specific external tool instead of using the internal
URL viewer. This can be used to integrate tools such as urlview. (example:
external-url-viewer "urlview")
feed-sort-order (parameters: <sortorder>; default value:
none)
If set to "firsttag", the feeds in
the feed list will be sorted by their first tag in the urls file. (example:
feed-sort-order firsttag)
feedlist-format (parameters: <format>; default value: "%4i
%n %11u %t")
This variable defines the format of entries in
the feed list. See the respective section in the documentation for more
information on format strings. (example: feedlist-format " %n %4i - %11u
-%> %t")
googlereader-flag-share (parameters: <flag>; default value:
"")
If this is set and Google Reader support is
used, then all articles that are flagged with the specified flag are being
"shared" in Google Reader so that people that follow you can see it.
(example: googlereader-flag-share "a")
googlereader-flag-star (parameters: <flag>; default value:
"")
If this is set and Google Reader support is
used, then all articles that are flagged with the specified flag are being
"starred" in Google Reader and appear in the list of "Starred
items". (example: googlereader-flag-star "b")
googlereader-login (parameters: <login>; default value:
"")
This variable sets your Google Reader login
for the Google Reader support. (example: googlereader-login
"your-login")
googlereader-min-items (parameters: <number>; default value:
20)
This variable sets the number of articles that
are loaded from Google Reader per feed. (example: googlereader-min-items
100)
googlereader-password (parameters: <password>; default value:
"")
This variable sets your Google Reader password
for the Google Reader support. (example: googlereader-password
"your-password")
googlereader-passwordfile (parameters: <path-to-file; default value:
"")
A more secure alternative to the above, by
storing your password elsewhere in your system. (example:
googlereader-passwordfile "path-to-file")
googlereader-show-special-feeds (parameters: [yes/no]; default value:
yes)
If this is set, then "special feeds"
like "People you follow" (articles shared by people you follow),
"Starred items" (your starred articles), "Shared items"
(your shared articles) and "Popular items" (articles considered to
be popular by Google’s magic algorithms) appear in your subscription
list. (example: googlereader-show-special-feeds "no")
goto-first-unread (parameters: [yes/no]; default value: yes)
If set to yes (the default), then the first
unread article will be selected whenever a feed is entered. (example:
goto-first-unread no)
goto-next-feed (parameters: [yes/no]; default value: yes)
If set to yes, then the next-unread and
prev-unread keys will search in other feeds for unread articles if all
articles in the current feed are read. If set to no, then the next-unread and
prev-unread keys will stop in the current feed. (example: goto-next-feed
no)
highlight (parameters: <target> <regex> <fgcolor>
[<bgcolor> [<attribute> ...]]; default value: n/a)
With this command, you can highlight text
parts in the feed list, the article list and the article view. For a detailed
documentation, see the chapter on highlighting. (example: highlight all
"newsbeuter" red)
highlight-article (parameters: <filterexpr> <fgcolor>
<bgcolor> [<attribute> ...]; default value: n/a)
With this command, you can highlight articles
in the article list if they match a filter expression. For a detailed
documentation, see the chapter on highlighting. (example: highlight-article
"author =~ \\"Andreas Krennmair\\"" white red bold)
history-limit (parameters: <number>; default value: 100)
Defines the maximum number of entries of
commandline resp. search history to be saved. To disable history saving, set
history-limit to 0. (example: history-limit 0)
html-renderer (parameters: <path>; default value: internal)
If set to "internal", then the
internal HTML renderer will be used. Otherwise, the specified command will be
executed, the HTML to be rendered will be written to the command’s
stdin, and the program’s output will be displayed. This makes it
possible to use other, external programs, such as w3m, links or lynx, to
render HTML. (example: html-renderer "w3m -dump -T text/html")
http-auth-method (parameters: <method>; default value: any)
Set HTTP authentication method. Allowed
values: any, basic, digest, digest_ie (only available with libcurl 7.19.3 and
newer), gssnegotiate, ntlm, anysafe. (example: http-auth-method digest)
ignore-article (parameters: <feed> <filterexpr>; default
value: n/a)
If a downloaded article from <feed>
matches <filterexpr>, then it is ignored and not presented to the user.
This command is further explained in the "kill file" section below.
(example: ignore-article "*" "title =~
\\"Windows\\"")
ignore-mode (parameters: [download/display]; default value:
download)
This configuration option defines in what way
an article is ignored (see ignore-article). If set to "download",
then it is ignored in the download/parsing phase (which is the default) and
thus never written to the cache, if it set to "display", it is
ignored when displaying articles but is kept in the cache. (example:
ignore-mode "display")
include (parameters: <path>; default value: n/a)
With this command, you can include other files
to be interpreted as configuration files. This is especially useful to
separate your configuration into several files, e.g. key configuration, color
configuration, ... (example: include "~/.newsbeuter/colors")
keep-articles-days (parameters: <days>; default value: 0)
If set the a number greater than 0, only
articles that are were published within the last <n> days are kept, and
older articles are deleted. If set to 0 (default value), this option is not
active. (example: keep-articles-days 30)
macro (parameters: <macro key> <command list>; default value:
n/a)
With this command, you can define a macro key
and specify a list of commands that shall be executed when the macro prefix
and the macro key are pressed. (example: macro k open ; reload ; quit)
mark-as-read-on-hover (parameters: [yes/no]; default value: no)
If set to yes, then all articles that get
selected in the article list are marked as read. (example:
mark-as-read-on-hover yes)
max-download-speed (parameters: <number>; default value: 0)
If set to a number great than 0, the download
speed per download is set to that limit (in kB). (example: max-download-speed
50)
max-items (parameters: <number>; default value: 0)
Set the number of articles to maximally keep
per feed. If the number is set to 0, then all articles are kept. (example:
max-items 100)
notify-format (parameters: <string>; default value:
"newsbeuter: finished reload, %f unread feeds (%n unread articles
total)")
Format string that is used for formatting
notifications. See the chapter on format strings for more information.
(example: notify-format "%d new articles (%n unread articles, %f unread
feeds)")
notify-program (parameters: <path>; default value:
"")
If set, then the configured program will be
executed if new articles arrived (through a reload) or if notify-always is
true. The first parameter of the called program contains the notification
message. (example: notify-program "~/bin/my-notifier")
notify-always (parameters: [yes/no]; default value: no)
If no, notifications will only be made when
there are new feeds or articles. If yes, notifications will be made
regardless. (example: notify-always yes)
notify-screen (parameters: [yes/no]; default value: no)
If yes, then a "privacy message"
will be sent to the terminal, containing a notification message about new
articles. This is especially useful if you use terminal emulations such as GNU
screen which implement privacy messages. (example: notify-screen yes)
notify-xterm (parameters: [yes/no]; default value: no)
If yes, then the xterm window title will be
set to a notification message about new articles. (example: notify-xterm
yes)
notify-beep (parameters: [yes/no]; default value: no)
If yes, then the speaker beep on new articles.
(example: notify-beep yes)
opml-url (parameters: <url> ...; default value:
"")
If the OPML online subscription mode is
enabled, then the list of feeds will be taken from the OPML file found on this
location. Optionally, you can specify more than one URL. All the listed OPML
URLs will then be taken into account when loading the feed list. (example:
opml-url "http://host.domain.tld/blogroll.opml"
"http://example.com/anotheropmlfile.opml")
pager (parameters: [<path>/internal]; default value:
internal)
If set to "internal", then the
internal pager will be used. Otherwise, the article to be displayed will be
rendered to be a temporary file and then displayed with the configured pager.
If the pager path is set to an empty string, the content of the
"PAGER" environment variable will be used. If the pager path
contains a placeholder "%f", it will be replaced with the temporary
filename. (example: less %f)
podcast-auto-enqueue (parameters: [yes/no]; default value: no)
If yes, then all podcast URLs that are found
in articles are added to the podcast download queue. See the respective
section in the documentation for more information on podcast support in
newsbeuter. (example: podcast-auto-enqueue yes)
prepopulate-query-feeds (parameters: [yes/no]; default value: no)
If yes, then all query feeds are prepopulated
with articles on startup. (example: prepopulate-query-feeds yes)
proxy (parameters: <server:port>; default value: n/a)
Set the proxy to use for downloading RSS
feeds. (example: proxy localhost:3128)
proxy-auth (parameters: <auth>; default value: n/a)
Set the proxy authentication string. (example:
proxy-auth user:password)
proxy-auth-method (parameters: <method>; default value: any)
Set proxy authentication method. Allowed
values: any, basic, digest, digest_ie (only available with libcurl 7.19.3 and
newer), gssnegotiate, ntlm, anysafe. (example: proxy-auth-method ntlm)
proxy-type (parameters: <type>; default value: http)
Set proxy type. Allowed values: http, socks4,
socks4a, socks5. (example: proxy-type socks5)
refresh-on-startup (parameters: [yes/no]; default value: no)
If yes, then all feeds will be reloaded when
newsbeuter starts up. This is equivalent to the -r commandline option.
(example: refresh-on-startup yes)
reload-only-visible-feeds (parameters: [yes/no]; default value:
no)
If yes, then manually reloading all feeds will
only reload the currently visible feeds, e.g. if a filter or a tag is set.
(example: reload-only-visible-feeds yes)
reload-time (parameters: <number>; default value: 60)
The number of minutes between automatic
reloads. (example: reload-time 120)
reload-threads (parameters: <number>; default value: 1)
The number of parallel reload threads that
shall be started when all feeds are reloaded. (example: reload-threads
3)
reset-unread-on-update (parameters: <url> ...; default value:
n/a)
With this configuration command, you can
provide a list of RSS feed URLs for whose articles the unread flag will be
reset if an article has been updated, i.e. its content has been changed. This
is especially useful for RSS feeds where single articles are updated after
publication, and you want to be notified of the updates. (example:
reset-unread-on-update "http://blog.fefe.de/rss.xml?html")
save-path (parameters: <path>; default value: ~/)
The default path where articles shall be saved
to. If an invalid path is specified, the current directory is used. (example:
save-path "~/Saved Articles")
search-highlight-colors (parameters: <fgcolor> <bgcolor>
[<attribute> ...]; default value: black yellow bold)
This configuration command specifies the
highlighting colors when searching for text from the article view. (example:
search-highlight-colors white black bold)
show-keymap-hint (parameters: [yes/no]; default value: yes)
If no, then the keymap hints on the bottom of
screen will not be displayed. (example: show-keymap-hint no)
show-read-feeds (parameters: [yes/no]; default value: yes)
If yes, then all feeds, including those
without unread articles, are listed. If no, then only feeds with one or more
unread articles are list. (example: show-read-feeds no)
show-read-articles (parameters: [yes/no]; default value: yes)
If yes, then all articles of a feed are listed
in the article list. If no, then only unread articles are listed. (example:
show-read-articles no)
suppress-first-reload (parameters: [yes/no]; default value: no)
If yes, then the first automatic reload will
be suppressed if auto-reload is set to yes. (example: suppress-first-reload
yes)
text-width (parameters: <number>; default value: 0)
If set to a number greater than 0, then all
HTML will be rendered to this maximum line length. If set to 0, the terminal
width will be used. (example: text-width 72)
ttrss-flag-publish (parameters: <character>; default value:
"")
If this is set and Tiny Tiny RSS support is
used, then all articles that are flagged with the specified flag are being
marked as "published" in Tiny Tiny RSS. (example: ttrss-flag-publish
"b")
ttrss-flag-star (parameters: <character>; default value:
"")
If this is set and Tiny Tiny RSS support is
used, then all articles that are flagged with the specified flag are being
"starred" in Tiny Tiny RSS. (example: ttrss-flag-star
"a")
ttrss-login (parameters: <username>; default value:
"")
Sets the username for use with Tiny Tiny RSS.
(example: ttrss-login "admin")
ttrss-mode (parameters: [multi/single]; default value: multi)
Configures the mode in which Tiny Tiny RSS is
used. In single-user mode, login and password are used for HTTP
authentication, while in multi-user mode, they are used for authenticating
with Tiny Tiny RSS. (example: ttrss-mode "single")
ttrss-passowrd (parameters: <password>; default value:
"")
Configures the password for use with Tiny Tiny
RSS. (example: ttrss-password "mypassword")
ttrss-url (parameters: <url>; default value: "")
Configures the URL where the Tiny Tiny RSS
installation you want to use resides. (example: ttrss-url
"http://example.com/ttrss/")
unbind-key (parameters: <key> [<dialog>]; default value:
n/a)
Unbind key <key>. This means that no
operation is called when <key> is pressed. Optionally, you can specify a
dialog (for a list of available dialogs, see "bind-key" above). If
you specify one, the key binding will only be unbound for the specified
dialog. (example: unbind-key R)
urls-source (parameters: <source>; default value:
"local")
This configuration command sets the source
where URLs shall be retrieved from. By default, this is ~/.newsbeuter/urls.
Alternatively, you can set it to "opml", which enables
newsbeuter’s OPML online subscription mode, to "ttrss" which
enables newsbeuter’s Tiny Tiny RSS support, or to
"googlereader", which enables newsbeuter’s Google Reader
support. In order to make Google Reader support work correctly, you also need
to set googlereader-login and googlereader-password, while the Tiny Tiny RSS
support requires login, password and URL of the Tiny Tiny RSS installation to
use (see above). (example: urls-source "googlereader")
use-proxy (parameters: [yes/no]; default value: no)
If yes, then the configured proxy will be used
for downloading the RSS feeds. (example: use-proxy yes)
user-agent (parameters: <user agent string>; default value:
"")
If set to a non-zero-length string, this value
will be used as HTTP User-Agent header for all HTTP requests. (example:
user-agent "Lynx/2.8.5rel.1 libwww-FM/2.14")
AVAILABLE OPERATIONS¶
open (default key: ENTER)Open the currently selected feed or
article.
quit (default key: q)
Quit the program or return to the previous
dialog (depending on the context).
reload (default key: r)
Reload the currently selected feed.
reload-all (default key: R)
Reload all feeds.
mark-feed-read (default key: A)
Mark all articles in the currently selected
feed read.
mark-all-feeds-read (default key: C)
Mark articles in all feeds read.
save (default key: s)
Save the currently selected article to a
file.
next-unread (default key: n)
Jump to the next unread article.
prev-unread (default key: p)
Jump to the previous unread article.
next (default key: J)
Jump to next article.
prev (default key: K)
Jump to previosu article.
random-unread (default key: ^K)
Jump to a random unread article.
open-in-browser (default key: o)
Opens the URL associated with the current
article.
open-in-browser-and-mark-read (default key: O)
Opens the URL associated with the current
article and marks the article as read.
help (default key: ?)
Runs the help screen.
toggle-source-view (default key: ^U)
Toggles between the HTML view and the source
view in the article view.
toggle-article-read (default key: N)
Toggle the read flag for the currently
selected article.
toggle-show-read-feeds (default key: l)
Toggle whether read feeds should be shown in
the feed list.
show-urls (default key: u)
Show all URLs in the article in a list
(similar to urlview).
clear-tag (default key: ^T)
Clear current tag.
set-tag (default key: t)
Select tag.
open-search (default key: /)
Opens the search dialog. When a search is done
in the article list, then the search operation only applies to the articles of
the current feed, otherwise to all articles.
goto-url (default key: #)
Open the URL dialog and then opens specified
URL.
enqueue (default key: e)
Add the podcast download URL of the current
article (if any is found) to the podcast download queue (see the respective
section in the documentation for more information on podcast support).
edit-urls (default key: E)
Edit the list of subscribed URLs. newsbeuter
will start the editor configured through the $VISUAL environment variable (if
unset, $EDITOR is used; fallback: "vi"). When editing is finished,
newsbeuter will reload the URLs file.
reload-urls (default key: ^R)
Reload the URLs configuration file.
redraw (default key: ^L)
Redraw the screen.
cmdline (default key: <colon>)
Open the command line.
set-filter (default key: F)
Set a filter.
select-filter (default key: f)
Select a predefined filter.
clear-filter (default key: ^F)
Clear currently set filter.
bookmark (default key: ^B)
Bookmark currently selected article or
URL.
edit-flags (default key: ^E)
Edit the flags of the currently selected
article.
next-unread-feed (default key: ^N)
Go to the next feed with unread articles. This
only works from the article list.
prev-unread-feed (default key: ^P)
Go to the previous feed with unread articles.
This only works from the article list.
next-feed (default key: j)
Go to the next feed. This only works from the
article list.
prev-feed (default key: k)
Go to the previous feed. This only works from
the article list.
delete-article (default key: D)
Delete the currently selected article.
purge-deleted (default key: $)
Purge all article that are marked as deleted
from the article list.
view-dialogs (default key: v)
View list of open dialogs.
close-dialog (default key: ^X)
Close currently selected dialog.
next-dialog (default key: ^V)
Go to next dialog.
prev-dialog (default key: ^G)
Go to previous dialog.
pipe-to (default key: |)
Pipe article to command.
sort (default key: g)
Sort feeds/articles by interactively choosing
the sort method.
revsort (default key: G)
Sort feeds/articles by interactively choosing
the sort method (reversed).
up (default key: UP)
Goes up one item in the list.
down (default key: DOWN)
Goes down one item in the list.
pageup (default key: PPAGE)
Goes up one page in the list.
pagedown (default key: NPAGE)
Goes down one page in the list.
TAGGING¶
Newsbeuter comes with the possibility to categorize or "tag", as we call it, RSS feeds. Every RSS feed can be assigned 0 or more tags. Within newsbeuter, you can then select to only show RSS feeds that match a certain tag. That makes it easy to categorize your feeds in a flexible and powerful way.http://blog.fefe.de/rss.xml?html interesting conspiracy news "cool stuff" http://rss.orf.at/news.xml news orf http://www.heise.de/newsticker/heise.rdf news interesting
http://rss.orf.at/news.xml "~ORF News"
SCRIPTS AND FILTERS¶
From version 0.4 on, newsbeuter contains support for Snownews extensions. The RSS feed readers Snownews and Liferea share a common way of extending the readers with custom scripts. Two mechanisms, namely "execurl" and "filter" type scripts, are available and supported by newsbeuter.exec:~/bin/execurl-script filter:~/bin/filter-script:http://some.test/url
"exec:~/bin/execurl-script param1 param2"
"filter:~/bin/filter-script param1 param2:http://url/foobar"
exec:~/bin/execurl-script tag1 tag2 "quoted tag" filter:~/bin/filter-script:http://some.test/url tag3 tag4 tag5
COMMAND LINE¶
Like other text-oriented software, newsbeuter contains an internal commandline to modify configuration variables ad hoc and to run own commands. It provides a flexible access to the functionality of newsbeuter which is especially useful for advanced users.Quit newsbeuter
save <filename>
Save current article to <filename>
set <variable>[=<value>|&|!]
Set (or get) configuration variable value.
Specifying a ! after the name of a boolean configuration variable
toggles their values, a & directly after the name of a
configuration variable of any type resets its value to the documented default
value.
tag <tagname>
Select a certain tag
goto <case-insensitive substring>
Go to the next feed whose name contains the
case-insensitive substring.
source <filename> [...]
Load the specified configuration files. This
allows it to load alternative configuration files or reload already loaded
configuration files on-the-fly from the filesystem.
dumpconfig <filename>
Save current internal state of configuration
to file, so that it can be instantly reused as configuration file.
<number>
Jump to the <number>th entry in the
current dialog
FILES¶
$HOME/.newsbeuter/configSEE 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@newsbeuter.org>, for contributors see AUTHORS file.06/23/2011 |