Newsboat

An actively maintained fork of newsbeuter.

NOTE:

unfortunately, cannot open in tags

Documentation

official docs	https://newsboat.org/releases/2.23/docs/newsboat.html
FAQ	https://newsboat.org/releases/2.23/docs/faq.html
man newsboat	https://man.archlinux.org/man/community/newsboat/newsboat.1.en
github	https://github.com/newsboat/newsboat
home	https://newsboat.org/
mailing list	https://groups.google.com/g/newsboat

Locations

~/.config/newsboat/config	config
~/.config/newsboat/urls	feed urls

Config

Syntax

# comment
`foo`  # commands between backticks are executed in shell

cron

You can reload interactively if you like, but you may also want to reload periodically in cron.

* */1 * * * /usr/bin/newsboat -x reload  # reload hourly

themes

include /usr/share/doc/newsboat/contrib/colorschemes/inkpot

color ${element} ${fg} ${bg} [${attr}]

keybindings

• named keys are in allcaps (ex: TAB, SPACE, ENTER)
• function keys are named (ex: F1)
• ctrl-keys are upper-cased with '^' (ex: ^O)

vi keybindings

# vi keybindings
unbind-key j
unbind-key k
unbind-key J
unbind-key K

bind-key j down
bind-key k up
bind-key l open
bind-key h quit
bind-key g home
bind-key G end

ttrss-flag-star "s"
ttrss-flag-publish "p"

macro o set browser "qutebrowser %u"; open-in-browser-noninteractively; set browser "w3m -o confirm_qq=false %u"

default keybindings

t   # show 'tags' (feed categories)
o   # open article in browser
,o  # open article in qutebrowser

macros

macros require a prefix to execute. (by default ,
For example the macro bound to 'o'

macro o set browser "qutebrowser %u"; open-in-browser-noninteractively; set browser "w3m %u"

requires the keypresses:

,o

Feeds

You can configure feeds, if you do not need them to stay synchronized on multiple devices.

chmod 640 ~/.config/newsboat/urls

# ~/.config/newsboat/urls

https://domain.com/rss.xml                  # no auth
https://${USER}:${PASS}@domain.com/rss.xml  # w/ auth
file:///var/log/rss.xml                     # local file

As Client

tt-rss

# ~/.newsboat/config

urls-source "ttrss"
ttrss-url "https://example.com/ttrss/"
ttrss-login "myusername"
ttrss-passwordeval "pass personal/web/ttrss"

ttrss-flag-star "s"
ttrss-flag-publish "p"

Checkout password options here