NEWSBOAT(1) NEWSBOAT(1) (NAME) newsboat - RSS/Atom (SYNOPSIS) newsboat [-r] [-e] [-i opmlfile] [-u urlfile] [-c cachefile] [-C configfile] [-X] [-o] [-x command...] [-h] (DESCRIPTION) Newsboat RSS/Atom . RSS Atom XML . Newsboat GNU/Linux BSD macOS . (OPTIONS) -h, --help -r, --refresh-on-start -e, --export-to-opml OPML stdout. OPML 1.0 2.0 . --export-to-opml2 OPML 2.0 stdout -X, --vacuum (cache) : ) ) . cleanup-on-quit delete-read-articles-on-quit keep-articles-days max-items . --cleanup Newsboat. urls . delete-read-articles-on-quit ( urls ). -v, -V, --version Newsboat -i opmlfile, --import-from-opml=opmlfile OPML -u urlfile, --url-file=urlfile URL -c cachefile, --cache-file=cachefile -C configfile, --config-file=configfile --queue-file=queuefile --search-history-file=searchhistoryfile --cmdline-history-file=cmdlinehistoryfile -x command ..., --execute=command... Newsboat. reload print-unread . -l loglevel, --log-level=loglevel loglevel ( : 1 6 ). --log-file . newsboat_.log . -d logfile, --log-file=logfile logfile . . -E file, --export-to-file=file ( GUID ). . -I file, --import-from-file=file . -E . (FIRST STEPS) Newsboat newsboat . : Error: no URLs configured. Please fill the file /home/ak/.newsboat/urls with RSS feed URLs or import an OPML file. Newsboat 2.22 usage: ./newsboat [-i |-e] [-u ] [-c ] [-x ...] [-h] -e, --export-to-opml export OPML feed to stdout -r, --refresh-on-start refresh feeds on start -i, --import-from-opml= import OPML file -u, --url-file= read RSS feed URLs from -c, --cache-file= use as cache file -C, --config-file= read configuration from -X, --vacuum compact the cache -x, --execute=... execute list of commands -q, --quiet quiet startup -v, --version get version information -l, --log-level= write a log with a certain loglevel (valid values: 1 to 6) -d, --log-file= use as output log file -E, --export-to-file= export list of read articles to -I, --import-from-file= import list of read articles from -h, --help this help --cleanup remove unreferenced items from cache Newsboat . (Adding Feeds) Newsboat ~/.newsboat/urls URL : http://rss.cnn.com/rss/cnn_topstories.rss http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml newsboat -i blogroll.opml OPML . # . Newsboat . URL cleanup-on-quit . / : https://username:password@hostname.domain.tld/feed.rss @ %40 . ~/.newsboat/urls : $ chmod u=rw,g=r,o= ~/.newsboat/urls Newsboat . file:// urls : file:///var/log/rss_eventlog.xml (First UI Interaction) Newsboat : -> -> Enter Q . Q -- Shift + Q -- Newsboat . / . . . (highlight) . history.search ( cache.db) . . history-limit . Newsboat . : o Shift + R . o R . o / . o Enter . o Q Newsboat. Newsboat . Newsboat RSS . max-items . (Caching) Newsboat HTTP . "Last-Modified" "ETag" ( ) HTTP . RSS . HTTP always-download . . N . : o Q . o / . o Enter . . . : o . # Enter . o O . o Q . . O . lynx . browser . (CONFIGURATION) Newsboat config urls . : ... # . (User contrib) Newsboat . /usr/share/doc/newsboat/contrib/ . . (Example) : # max-items& 100 # browser& links show-read-feeds& no unbind-key& R bind& ^R feedlist reload-all (Splitting long lines into multiple ones) ignore-article . . . \ \ . : macro p open; \ reload; quit; \ quit;& \ quit -- "Opens, reloads then makes sure to quit newsboat" Newsboat . . : ignore-article \ "*" \ "author =~ \"(\ John Doe| \ Mary Sue \ )\"" : ignore-article "*" "author =~ \"(John Doe|Mary Sue)\"" : ignore-article& "*"& "author =~ \"(& John Doe|& Mary Sue& )\"" . (Using Double Quotes) (TL;DR) (double quote) . ( \") ( \\) escape . escape -- Newsboat . Newsboat URL . . Newsboat . Newsboat ( ) : browser "firefox --new-tab %u" escape : ocnews-password "UnbalancedQuotes\"AreSoFun!" escape ! my favourite pager . Newsboat escape . Newsboat escape . : pager "/usr/bin/my\\ favourite\\ pager" (Shell Evaluation) . ` . Bourne . (Escaping) # ( \` \#). ` # . (Key Bindings) Newsboat . bind ( ) ( ) . : bind [,] [-- ""] : . : bind ab everywhere bind abc everywhere abc . ab . ab Newsboat ab c . : o ( ab bcd) o ( ab abd abc ). (Key Sequence) . Ctrl (caret) ^ . Ctrl + R ^R . Ctrl . Shift Ctrl Shift + A Ctrl + A . bind bind-key . : o ( Enter) o ( Backspace) o ( ) o ( ) o ( ) o ( ) o ( Page Up) o ( Page Down) o ( /) o ( /) o ( Esc) o ( Tab) o ( <) o ( >) o <^> ( ^ ^ ) o ( F1 F12) . gg g ^O Ctrl + O Enter . Esc . (Dialog) (dialog) . : o everywhere ( ) o feedlist ( ) o filebrowser ( ) o help () o articlelist ( ) o article () o tagselection ( ) o filterselection ( ) o urlview ( ) o podboat ( podboat) o dirbrowser ( ) o searchresultslist ( ) . : bind k feedlist,articlelist,urlview up bind j feedlist,articlelist,urlview down everywhere : bind k everywhere up bind j everywhere down (Operation List) . [_newsboat_operations] [_podboat_operations] . (;) . set . ( -- "some description"). . : bind of everywhere set browser "firefox" ; open-in-browser -- "Open in Firefox" o f firefox open-in-browser / . bind . bind . (macro-prefix ) bind . (Old Style Key Bindings) bind-key . . . : bind-key [] (Key) . Ctrl (caret) ^ . Ctrl + R ^R . Ctrl . : o ENTER ( Enter) o BACKSPACE ( Backspace) o LEFT ( ) o RIGHT ( ) o UP ( ) o DOWN ( ) o PPAGE ( Page Up) o NPAGE ( Page Down) o HOME ( /) o END ( /) o ESC ( Esc) o TAB ( Tab) o F1 F12 ( F1 F12) (Operation) . [_newsboat_operations] [_podboat_operations] . (Dialog) (dialog) . : o all ( ) o feedlist o filebrowser o help o articlelist o article o tagselection o filterselection o urlview o podboat o dirbrowser o searchresultslist (Colors) Newsboat . : color [ ...] . : o black () o red () o green () o yellow () o blue () o magenta () o cyan () o white () o default () o color color123 default . color ( ) ( gnome-terminal xterm TERM xterm-256color) . Newsboat . : . . : o standout o underline o reverse o blink o dim o bold o protect o invis : o background: o listnormal: o listfocus: o listnormal_unread: o listfocus_unread: o title ( ): ( show-title-bar swap-title-and-hints ). info o info: ( show-keymap-hint swap-title-and-hints ) o hint-key ( ): . info o hint-keys-delimiter ( ): . info o hint-separator ( ): . info o hint-description ( ): . info o article: o end-of-text-marker: (~) Newsboat : color background& white& black color listnormal& white& black color listfocus& yellow& blue& bold color listnormal_unread& white& black& bold color listfocus_unread& yellow& blue& bold color title& yellow& blue& bold color info& yellow& blue& bold color hint-key& yellow& blue& bold color hint-keys-delimiter white& blue color hint-separator& white& blue& bold color hint-description& white& blue color article& white& black (CONFIGURATION COMMANDS) always-display-description (: [yes/no] : no) yes . (: always-display-description yes) always-download (: [...] : n/a) URL Last-Modified ETag . . (: always-download "https://www.n-tv.de/23.rss") article-sort-order (: [-] : date-asc) . : date title flags author link guid random. asc desc . random . date desc ( date date-desc ) asc . date : desc asc . Newsboat . (: article-sort-order author-desc) articlelist-format (: : "%4i %f %D %6L %?T?|%-17T| ?%t") . FORMAT STRINGS . (: articlelist-format "%4i %f %D %?T?|%-17T| ?%t") articlelist-title-format (: : "%N %V - Articles in feed '%T' (%u unread, %t total)%?F? matching filter '%F'&? - %U" ()) . FORMAT STRINGS Newsboat . (: articlelist-title-format "Articles in feed '%T' (%u unread)") auto-reload (: [yes/no] : no) yes ( reload-time ) . refresh-on-startup . suppress-first-reload . (: auto-reload yes) bind (: [,] [-- ""] : n/a) . ( ). Key Bindings . . unbind-key . (: bind of everywhere set browser "firefox" ; open-in-browser) bind-key (: [] : n/a) . ( ). Old Style Key Bindings . unbind-key . (: bind-key ^R reload-all) bookmark-autopilot (: [yes/no] : no) yes URL / . (: bookmark-autopilot yes) bookmark-cmd (: : "") . . (: bookmark-cmd "~/bin/delicious-bookmark.sh") bookmark-interactive (: [yes/no] : no) yes . (: bookmark-interactive yes) browser (: : %BROWSER lynx) . BROWSER lynx . Using Browser . (: browser "w3m %u") cache-file (: : "~/.newsboat/cache.db" "~/.local/share/cache.db" ( FILES )) . ( NFS). (: cache-file "/tmp/testcache.db") cleanup-on-quit (: [yes/no/nudge] : nudge) yes urls . newsboat --cleanup . error-log . nudge Newsboat . (: cleanup-on-quit yes) color (: [ ...] : n/a) . Colors . (: color background white black) confirm-delete-all-articles (: [yes/no] : yes) yes Newsboat . (: confirm-delete-all-articles no) confirm-exit (: [yes/no] : no) yes Newsboat . (: confirm-exit yes) confirm-mark-all-feeds-read (: [yes/no] : yes) yes Newsboat . (: confirm-mark-all-feeds-read no) confirm-mark-feed-read (: [yes/no] : yes) yes Newsboat . (: confirm-mark-feed-read no) cookie-cache (: : "") . Netscape . . (: cookie-cache "~/.newsboat/cookies.txt") datetime-format (: : %b %d) / . strftime(3) . %L strftime ( "2 days ago"). (: datetime-format "%D, %R") define-filter (: : n/a) . . (: define-filter "all feeds with 'fun' tag" "tags # \"fun\"") delete-read-articles-on-quit (: [yes/no] : no) yes Newsboat . cleanup-on-quit yes --cleanup . (: delete-read-articles-on-quit yes) dialogs-title-format (: : "%N %V - Dialogs" ()) . FORMAT STRINGS Newsboat . (: dialogs-title-format "%N %V - Dialogs") dirbrowser-title-format (: : "%N %V - %?O?Open Directory&Save File? - %f" ()) . FORMAT STRINGS Newsboat . (: dirbrowser-file-format "%?O?Open Directory&Save File? - %f") display-article-progress (: [yes/no] : yes) yes . . (: display-article-progress no) download-full-page (: [yes/no] : no) yes . <<>> . (: download-full-page yes) download-retries (: : 1) Newsboat . ( TOR) . (: download-retries 4) download-timeout (: : 30) Newsboat . ( TOR) . (: download-timeout 60) error-log (: : "") ( RSS) . (: error-log "~/.newsboat/error.log") external-url-viewer (: : "") show-urls (pipe) . urlview . (: external-url-viewer "urlview") feed-sort-order (: [-] : none) : firsttag title articlecount unreadarticlecount lastupdated latestunread none. asc desc . desc . (: feed-sort-order firsttag) feedbin-flag-star (: : "") Feedbin Feedbin "Starred items" . (: feedbin-flag-star "b") feedbin-login (: : "") Feedbin . (: feedbin-login "your-login") feedbin-password (: : "") Feedbin . escape . (: feedbin-password "here_goesAquote:\"") feedbin-passwordeval (: : "") . gpg . (: feedbin-passwordeval "gpg --decrypt ~/.newsboat/feedbin-password.gpg") feedbin-passwordfile (: : "") . (: feedbin-passwordfile "~/.newsboat/feedbin-pw.txt") feedbin-url (: : "https://api.feedbin.com") Feedbin . (: feedbin-url "https://example.com/feedbin") feedhq-flag-share (: : "") FeedHQ FeedHQ . (: feedhq-flag-share "a") feedhq-flag-star (: : "") FeedHQ FeedHQ "Starred items" . (: feedhq-flag-star "b") feedhq-login (: : "") FeedHQ . (: feedhq-login "your-login") feedhq-min-items (: : 20) FeedHQ . (: feedhq-min-items 100) feedhq-password (: : "") FeedHQ . escape . (: feedhq-password "here_goesAquote:\"") feedhq-passwordeval (: : "") . gpg . (: feedhq-passwordeval "gpg --decrypt ~/.newsboat/feedhq-password.gpg") feedhq-passwordfile (: : "") . (: feedhq-passwordfile "~/.newsboat/feedhq-pw.txt") feedhq-show-special-feeds (: [yes/no] : yes) FeedHQ << >> "People you follow" ( ) "Starred items" ( ) "Shared items" ( ) . (: feedhq-show-special-feeds "no") feedhq-url (: : "https://feedhq.org") URL FeedHQ . (: feedhq-url "https://feedhq.example.com") feedlist-format (: : "%4i %n %11u %t") . FORMAT STRINGS . (: feedlist-format " %n %4i - %11u -%> %t") feedlist-title-format (: : "%N %V - %?F?Feeds&Your feeds? (%u unread, %t total)%?F? matching filter '%F'&?%?T? - tag '%T'&?" ()) . FORMAT STRINGS Newsboat . (: feedlist-title-format "Feeds (%u unread, %t total)") filebrowser-title-format (: : "%N %V - %?O?Open File&Save File? - %f" ()) . FORMAT STRINGS Newsboat . (: filebrowser-title-format "%?O?Open File&Save File? - %f") freshrss-flag-star (: : "") FreshRSS FreshRSS "Starred items" . (: freshrss-flag-star "b") freshrss-login (: : "") FreshRSS . (: freshrss-login "your-login") freshrss-min-items (: : 20) FreshRSS . (: freshrss-min-items 100) freshrss-password (: : "") FreshRSS . escape . (: freshrss-password "here_goesAquote:\"") freshrss-passwordeval (: : "") . gpg . (: freshrss-passwordeval "gpg --decrypt ~/.newsboat/freshrss-password.gpg") freshrss-passwordfile (: : "") . (: freshrss-passwordfile "~/.newsboat/freshrss-pw.txt") freshrss-show-special-feeds (: [yes/no] : yes) FreshRSS "Starred items" ( / ) . (: freshrss-show-special-feeds "no") freshrss-url (: : "") URL Google Reader API FreshRSS . (: freshrss-url "https://freshrss.example.com/api/greader.php") goto-first-unread (: [yes/no] : yes) yes . (: goto-first-unread no) goto-next-feed (: [yes/no] : yes) yes next-unread prev-unread random-unread . no . (: goto-next-feed no) help-title-format (: : "%N %V - Help" ()) . FORMAT STRINGS Newsboat . (: help-title-format "%N %V - Help") highlight (: [ [ ...]] : n/a) (highlight) . Colors . (: highlight all "newsboat" red) highlight-article (: [ ...] : n/a) . Colors . (: highlight-article "author =~ \"Andreas Krennmair\"" white red bold) highlight-feed (: [ ...] : n/a) . Colors . (: highlight-feed unread > 100 white red bold) history-limit (: : 100) . 0 . (: history-limit 0) html-renderer (: : internal) internal HTML . HTML (stdin) . w3m links lynx HTML . (: html-renderer "w3m -dump -T text/html") http-auth-method (: : any) HTTP . : any basic digest digest_ie ( libcurl 7.19.3 ) gssnegotiate ntlm anysafe. (: http-auth-method digest) ignore-article (: : n/a) . KILLFILES . (: ignore-article "*" "title =~ \"Windows\"") ignore-mode (: [download/display] : download) ( ignore-article ). download / display . (: ignore-mode "display") include (: : n/a) . ( ...) . (: include "~/.newsboat/colors") inoreader-app-id (: : "") (App ID) Inoreader. "Inoreader" . (: inoreader-app-id "123456789") inoreader-app-key (: : "") (App Key) Inoreader. "Inoreader" . (: inoreader-app-key "TmV3c2JvYXQgcm9ja3MgOikK") inoreader-flag-share (: : "") Inoreader Inoreader . (: inoreader-flag-share "a") inoreader-flag-star (: : "") Inoreader Inoreader "Starred items" . (: inoreader-flag-star "b") inoreader-login (: : "") Inoreader . (: inoreader-login "your-login") inoreader-min-items (: : 20) Inoreader . (: inoreader-min-items 100) inoreader-password (: : "") Inoreader . escape . (: inoreader-password "here_goesAquote:\"") inoreader-passwordeval (: : "") . (: inoreader-passwordeval "gpg --decrypt ~/.newsboat/inoreader-password.gpg") inoreader-passwordfile (: : "") . (: inoreader-passwordfile "~/.newsboat/inoreader-pw.txt") inoreader-show-special-feeds (: [yes/no] : yes) Inoreader "Starred items" ( ) "Shared items" ( ) . (: inoreader-show-special-feeds "no") itemview-title-format (: : "%N %V - Article '%T' (%u unread, %t total)" ()) . FORMAT STRINGS Newsboat . (: itemview-title-format "Article '%T'") keep-articles-days (: : 0) 0 . 0 . . (: keep-articles-days 30) macro (: [-- ""] : n/a) . . . (: macro k open; reload; quit -- "enter feed to reload it") mark-as-read-on-hover (: [yes/no] : no) yes . (: mark-as-read-on-hover yes) max-browser-tabs (: : 10) open-all-unread-in-browser open-all-unread-in-browser-and-mark-read . (: max-browser-tabs 4) max-download-speed (: : 0) 0 ( ) . (: max-download-speed 50) max-items (: : 0) . . 0 . (: max-items 100) miniflux-flag-save (: : "") Miniflux Miniflux . (: miniflux-flag-save "b") miniflux-flag-star (: : "") Miniflux Miniflux "Starred items" . (: miniflux-flag-star "b") miniflux-login (: : "") Miniflux . (: miniflux-login "admin") miniflux-min-items (: : 100) Miniflux . (: miniflux-min-items 20) miniflux-password (: : "") Miniflux . escape . (: miniflux-password "here_goesAquote:\"") miniflux-passwordeval (: : "") . gpg . (: miniflux-passwordeval "gpg --decrypt ~/.newsboat/miniflux-password.gpg") miniflux-passwordfile (: : "") . (: miniflux-passwordfile "~/.newsboat/miniflux-pw.txt") miniflux-show-special-feeds (: [yes/no] : yes) Miniflux "Starred items" ( ) . (: miniflux-show-special-feeds "no") miniflux-token (: : "") API Miniflux . (: miniflux-token "E-uTqU8r55KucuHz26tJbXfrZVRndwY_mZAsEfcC8Bg=") miniflux-tokeneval (: : "") API . (: miniflux-tokeneval "gpg --decrypt ~/.newsboat/miniflux-token.gpg") miniflux-tokenfile (: : "") . (: miniflux-tokenfile "~/.newsboat/miniflux-token.txt") miniflux-url (: : "") URL Miniflux . (: miniflux-url "https://example.com/miniflux") newsblur-login (: : "") NewsBlur . (: newsblur-login "your-login") newsblur-min-items (: : 20) NewsBlur . (: newsblur-min-items 100) newsblur-password (: : "") NewsBlur . escape . (: newsblur-password "here_goesAquote:\"") newsblur-passwordeval (: : "") . (: newsblur-passwordeval "gpg --decrypt ~/.newsboat/newsblur-password.gpg") newsblur-passwordfile (: : "") . (: newsblur-passwordfile "~/.newsboat/newsblur-pw.txt") newsblur-url (: : "https://newsblur.com") URL NewsBlur . (: newsblur-url "https://localhost") notify-always (: [yes/no] : no) no . yes . (: notify-always yes) notify-beep (: [yes/no] : no) yes . (: notify-beep yes) notify-format (: : "Newsboat: finished reload, %f unread feeds (%n unread articles total)" ()) . (: notify-format "%d new articles (%n unread articles, %f unread feeds)") notify-program (: : "") ( ) notify-always . . . (: notify-program "~/bin/my-notifier") notify-screen (: [yes/no] : no) yes << >> . GNU screen . (: notify-screen yes) notify-xterm (: [yes/no] : no) yes xterm . (: notify-xterm yes) ocnews-flag-star (: : "") ownCloud News ownCloud News . (: ocnews-flag-star "s") ocnews-login (: : "") ownCloud . (: ocnews-login "user") ocnews-password (: : "") ownCloud . escape . (: ocnews-password "here_goesAquote:\"") ocnews-passwordeval (: : "") . gpg . (: ocnews-passwordeval "gpg --decrypt ~/.newsboat/ocnews-password.gpg") ocnews-passwordfile (: : "") . (: ocnews-passwordfile "~/.newsboat/ocnews-pw.txt") ocnews-url (: : "") URL ownCloud . (: ocnews-url "https://localhost/owncloud") oldreader-flag-share (: : "") The Old Reader The Old Reader . (: oldreader-flag-share "a") oldreader-flag-star (: : "") The Old Reader The Old Reader "Starred items" . (: oldreader-flag-star "b") oldreader-login (: : "") The Old Reader . (: oldreader-login "your-login") oldreader-min-items (: : 20) The Old Reader . (: oldreader-min-items 100) oldreader-password (: : "") The Old Reader . escape . (: oldreader-password "here_goesAquote:\"") oldreader-passwordeval (: : "") . gpg . (: oldreader-passwordeval "gpg --decrypt ~/.newsboat/oldreader-password.gpg") oldreader-passwordfile (: : "") . (: oldreader-passwordfile "~/.newsboat/oldreader-pw.txt") oldreader-show-special-feeds (: [yes/no] : yes) The Old Reader "People you follow" ( ) "Starred items" ( ) "Shared items" ( ) . (: oldreader-show-special-feeds "no") openbrowser-and-mark-jumps-to-next-unread (: [yes/no] : no) yes . (: openbrowser-and-mark-jumps-to-next-unread yes) opml-url (: ... : "") OPML OPML . . . (: opml-url "https://host.domain.tld/blogroll.opml" "https://example.com/anotheropmlfile.opml") pager (: [/internal] : internal) internal () . . PAGER . %f . (: pager "less %f") podcast-auto-enqueue (: [yes/no] : no) yes . PODCAST SUPPORT . (: podcast-auto-enqueue yes) prepopulate-query-feeds (: [yes/no] : no) yes (query feeds) . (: prepopulate-query-feeds yes) proxy (: : n/a) RSS . ( use-proxy yes .) NO_PROXY . (: proxy localhost:3128) proxy-auth (: : n/a) . (: proxy-auth user:password) proxy-auth-method (: : any) . : any basic digest digest_ie ( libcurl 7.19.3 ) gssnegotiate ntlm anysafe. (: proxy-auth-method ntlm) proxy-type (: : http) . : http socks4 socks4a socks5 socks5h. (: proxy-type socks5) refresh-on-startup (: [yes/no] : no) yes . -r . auto-reload . (: refresh-on-startup yes) reload-only-visible-feeds (: [yes/no] : no) yes ( ) . (: reload-only-visible-feeds yes) reload-threads (: : 1) (threads) . (: reload-threads 3) reload-time (: : 60) . (: reload-time 120) reset-unread-on-update (: [...] : n/a) URL . . . (: reset-unread-on-update "https://blog.fefe.de/rss.xml?html") restrict-filename (: [yes/no] : yes) no Newsboat ASCII . (: restrict-filename no) run-on-startup (: : n/a) Newsboat (;) Newsboat . (: run-on-startup next-unread; open; random-unread; open) save-path (: : ~/) . . (: save-path "~/Saved Articles") scrolloff (: : 0) . . (: scrolloff 5) search-highlight-colors (: [ ...] : black yellow bold) . Colors . (: search-highlight-colors white black bold) searchresult-title-format (: : "%N %V - Search results for '%s' (%u unread, %t total)%?F? matching filter '%F'&?" ()) . FORMAT STRINGS . (: searchresult-title-format "Search result") selectfilter-title-format (: : "%N %V - Select Filter" ()) . FORMAT STRINGS Newsboat . (: selectfilter-title-format "Select Filter") selecttag-format (: : "%4i %T (%u)") "Select tag". FORMAT STRINGS . (: selecttag-format "[%2i] %T (%n unread articles in %f feeds, %u feeds total)") selecttag-title-format (: : "%N %V - Select Tag" ()) . FORMAT STRINGS Newsboat . (: selecttag-title-format "Select Tag") show-keymap-hint (: [yes/no] : yes) no . ( swap-title-and-hints .) (: show-keymap-hint no) show-read-articles (: [yes/no] : yes) yes . no . (: show-read-articles no) show-read-feeds (: [yes/no] : yes) yes . no . (: show-read-feeds no) show-title-bar (: [yes/no] : yes) no . ( swap-title-and-hints .) (: show-title-bar no) ssl-verifyhost (: [yes/no] : yes) no . (: ssl-verifyhost no) ssl-verifypeer (: [yes/no] : yes) no SSL . (: ssl-verifypeer no) suppress-first-reload (: [yes/no] : no) yes auto-reload . (: suppress-first-reload yes) swap-title-and-hints (: [yes/no] : no) yes ( ) ( ) . show-keymap-hint show-title-bar . (: swap-title-and-hints yes) text-width (: : 0) 0 HTML ( ) . 0 pipe-to save save-all 80 (wrap) . . "Link" "Links" . (: text-width 72) toggleitemread-jumps-to-next (: [yes/no] : yes) yes . no . (: toggleitemread-jumps-to-next no) toggleitemread-jumps-to-next-unread (: [yes/no] : no) yes . no toggleitemread-jumps-to-next . (: toggleitemread-jumps-to-next-unread yes) ttrss-flag-publish (: : "") Tiny Tiny RSS Tiny Tiny RSS "published" . (: ttrss-flag-publish "b") ttrss-flag-star (: : "") Tiny Tiny RSS Tiny Tiny RSS . (: ttrss-flag-star "a") ttrss-login (: : "") Tiny Tiny RSS . (: ttrss-login "admin") ttrss-mode (: [multi/single] : multi) Tiny Tiny RSS . (single) HTTP (multi) Tiny Tiny RSS . (: ttrss-mode "single") ttrss-password (: : "") Tiny Tiny RSS . escape . (: ttrss-password "here_goesAquote:\"") ttrss-passwordeval (: : "") . gpg . (: ttrss-passwordeval "gpg --decrypt ~/.newsboat/ttrss-password.gpg") ttrss-passwordfile (: : "") . (: ttrss-passwordfile "~/.newsboat/ttrss-pw.txt") ttrss-url (: : "") URL Tiny Tiny RSS . (: ttrss-url "https://example.com/ttrss") unbind-key (: [] : n/a) (unbind) . . (Key) . "-a" . . (: unbind-key R) urls-source (: : "local") URL . urls . opml ( OPML) ttrss ( Tiny Tiny RSS) oldreader ( The Old Reader) newsblur ( NewsBlur) feedbin Feedbin feedhq FeedHQ freshrss FreshRSS ocnews ownCloud News inoreader Inoreader miniflux Miniflux . urls . (: urls-source "oldreader") urlview-title-format (: : "%N %V - URLs" ()) . FORMAT STRINGS Newsboat . (: urlview-title-format "URLs") use-proxy (: [yes/no] : no) yes RSS . (: use-proxy yes) user-agent (: : "") HTTP User-Agent HTTP . (: user-agent "Lynx/2.8.5rel.1 libwww-FM/2.14") wrap-scroll (: [yes/no] : no) yes . (: wrap-scroll yes) (AVAILABLE OPERATIONS) open ( : ENTER) . quit ( : Q) ( ). hard-quit ( : Shift + Q) . reload ( : R) . reload-all ( : Shift + R) . mark-feed-read ( : Shift + A) . mark-all-feeds-read ( : Shift + C) . mark-all-above-as-read ( : n/a) . save ( : S) text-width. save-all ( : n/a) text-width. next-unread ( : N) . prev-unread ( : P) . next ( : Shift + J) . prev ( : Shift + K) . random-unread ( : Ctrl + K) . open-in-browser ( : O) . open-in-browser-noninteractively ( : n/a) URL . open-in-browser (stdout stderr) . & browser . open-in-browser-and-mark-read ( : Shift + O) URL. . open-all-unread-in-browser ( : n/a) . open-all-unread-in-browser-and-mark-read ( : n/a) . help ( : ?) . toggle-source-view ( : Ctrl + U) HTML . toggle-article-read ( : Shift + N) . toggle-show-read-feeds ( : L) . show-urls ( : U) ( urlview). clear-tag ( : Ctrl + T) . set-tag ( : T) . open-search ( : /) . . goto-url ( : #) URL . one ( : 1) . two ( : 2) . three ( : 3) . four ( : 4) . five ( : 5) . six ( : 6) . seven ( : 7) . eight ( : 8) . nine ( : 9) . zero ( : 0) . cmd-one ( : 1) . cmd-two ( : 2) . cmd-three ( : 3) . cmd-four ( : 4) . cmd-five ( : 5) . cmd-six ( : 6) . cmd-seven ( : 7) . cmd-eight ( : 8) . cmd-nine ( : 9) . enqueue ( : E) ( ) . PODCAST SUPPORT . edit-urls ( : Shift + E) URL . Newsboat . : %f ( urls) %L ( urls 0 urls). VISUAL EDITOR (: vi) . Newsboat URLs . : bind E feedlist,articlelist,searchresultslist edit-urls "vim +%L %f" reload-urls ( : Ctrl + R) URLs. redraw ( : Ctrl + L) . cmdline ( : :) . : bind c everywhere cmdline "source ~/.newsboat/config" set-filter ( : Shift + F) . select-filter ( : F) . clear-filter ( : Ctrl + F) . bookmark ( : Ctrl + B) URL . edit-flags ( : Ctrl + E) . next-unread-feed ( : Ctrl + N) . . prev-unread-feed ( : Ctrl + P) . . next-feed ( : J) . . prev-feed ( : K) . . delete-article ( : Shift + D) . delete-all-articles ( : Ctrl + D) . ( show-read-articles no) ( ) -- delete-all-articles () . purge-deleted ( : $) . view-dialogs ( : V) . close-dialog ( : Ctrl + X) . next-dialog ( : Ctrl + V) . prev-dialog ( : Ctrl + G) . pipe-to ( : |) (pipe). text-width . sort ( : G) / . rev-sort ( : Shift + G) / . up ( : UP) . down ( : DOWN) . pageup ( : PPAGE) . pagedown ( : NPAGE) . halfpageup ( : n/a) . halfpagedown ( : n/a) . home ( : HOME) . end ( : END) . macro-prefix ( : ,) . . switch-focus ( : TAB) . filebrowser dirbrowser . goto-title ( : n/a) ( ). prevsearchresults ( : Z) ( ). searchresultslist . article-feed ( : n/a) . (FORMAT STRINGS) . printf C . % : (pad) . . %=[width][identifier] w=0 . %>[char] [char] . : %?[char]?[format 1]&[format 2]?: [char] [format 1] [format 2] . & [format 2] . : . feedlist-format +----------------+-----------------------------------------------------+ | | | +----------------+-----------------------------------------------------+ |d | | +----------------+-----------------------------------------------------+ |i | | +----------------+-----------------------------------------------------+ |l | | +----------------+-----------------------------------------------------+ |L | URL RSS | +----------------+-----------------------------------------------------+ |n | | | | "" | +----------------+-----------------------------------------------------+ |S | | +----------------+-----------------------------------------------------+ |t | | +----------------+-----------------------------------------------------+ |T | | | | URLs | +----------------+-----------------------------------------------------+ |u | | | | "/" | +----------------+-----------------------------------------------------+ |U | "" | +----------------+-----------------------------------------------------+ |c | "" | +----------------+-----------------------------------------------------+ reload-all " " ( "_" ) " " ( "." ) ( " " ) " " ( "x" ) . . articlelist-format +----------------+-------------------------------------+ | | | +----------------+-------------------------------------+ |a | | | | | +----------------+-------------------------------------+ |D | . | | | | | | | | | datetime-format | | | | | | | +----------------+-------------------------------------+ |f | : ) "N" | | | | | | | | | "D" | | | | | | | | | | | | ) "!" | | | | | | | | | | | | | | | . | +----------------+-------------------------------------+ |n | | | | "" | +----------------+-------------------------------------+ |d | | | | "" | +----------------+-------------------------------------+ |F | | | | | +----------------+-------------------------------------+ |i | | +----------------+-------------------------------------+ |t | | +----------------+-------------------------------------+ |T | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | . | +----------------+-------------------------------------+ |L | | +----------------+-------------------------------------+ |e | URL | | | | +----------------+-------------------------------------+ . selecttag-format +----------------+-----------------------------------------------+ | | | +----------------+-----------------------------------------------+ |i | | +----------------+-----------------------------------------------+ |T | | | | | +----------------+-----------------------------------------------+ |f | | | | | | | | +----------------+-----------------------------------------------+ |n | | | | | | | | | | | | | | +----------------+-----------------------------------------------+ |u | | | | | | | | +----------------+-----------------------------------------------+ . notify-format +----------------+-----------------------------------+ | | | +----------------+-----------------------------------+ |n | | | | | | | | +----------------+-----------------------------------+ |f | | | | | | | | +----------------+-----------------------------------+ |d | | | | | | | | | | ( | | | | | | | | | | | | | | | ) | +----------------+-----------------------------------+ |D | | | | | | | | | | ( | | | | | | | | | | | | | | | ) | +----------------+-----------------------------------+ . podlist-format +----------------+--------------------------------------+ | | | +----------------+--------------------------------------+ |i | | | | | +----------------+--------------------------------------+ |d | | | | | | | | | | | | | | | | | | | | +----------------+--------------------------------------+ |t | | | | | | | | | | | | | | | | | +----------------+--------------------------------------+ |p | | | | | | | | | | | | | | +----------------+--------------------------------------+ |k | | | | | | | | | | | | | KB/s | | | ( "KB/s" | | | ) | +----------------+--------------------------------------+ |K | | | | | | | | | | | | | ( | | | | | | KB/s MB/s GB/s | | | ) | +----------------+--------------------------------------+ |S | | | | | | | | | | | | | : "queued" | | | "downloading" "ready" | | | "canceled" "deleted" | | | "missing" "played" "finished" | | | "failed" | +----------------+--------------------------------------+ |u | URL | | | | +----------------+--------------------------------------+ |F | | | | | | | | | | ( | | | ~/downloads/podcast.mp3 -> | | | /home/name/downloads/podcast.mp3) | +----------------+--------------------------------------+ |b | (basename) | | | | | | ( | | | /home/name/downloads/podcast.mp3 | | | -> podcast.mp3) | +----------------+--------------------------------------+ . download-path download-filename-format +----------------+----------------------------------------------+ | | | +----------------+----------------------------------------------+ |u | | | | URL . | | | | | | . | | | | | | | | | | | | . | +----------------+----------------------------------------------+ |n | | +----------------+----------------------------------------------+ |N | | | | . | | | | | | | | | | | | | | | | +----------------+----------------------------------------------+ |h | (hostname) | | | | +----------------+----------------------------------------------+ |t | | | | | +----------------+----------------------------------------------+ |e | | | | | +----------------+----------------------------------------------+ |F | | | | | | | | | | yyyy-mm-dd | +----------------+----------------------------------------------+ |m | | | | | | | | +----------------+----------------------------------------------+ |b | | | | | | | | +----------------+----------------------------------------------+ |d | | | | | | | | +----------------+----------------------------------------------+ |H | | | | | | | | +----------------+----------------------------------------------+ |M | | | | | | | | +----------------+----------------------------------------------+ |S | | | | | | | | +----------------+----------------------------------------------+ |y | | | | | | | | | | yy | +----------------+----------------------------------------------+ |Y | | | | | | | | | | yyyy | +----------------+----------------------------------------------+ : feedlist-format "%4i %n %11u %t" articlelist-format "%4i %f %D %?T?|%-17T| ?%t" notify-format "%d new articles (%n unread articles, %f unread feeds)" podlist-format "%4i [%-5p %%] %-12S %F" (DIALOG TITLES) () . . (locale) . . +----------------------------+---------------------------+-----------------------+ | | | | | | | | +----------------------------+---------------------------+-----------------------+ | | feedlist-title-format | %N %V - | | | | %?F?Feeds&Your feeds? | | | | (%u unread, %t | | | | total)%?F? matching | | | | filter '%F'&?%?T? - | | | | tag '%T'&? | +----------------------------+---------------------------+-----------------------+ | | articlelist-title-format | %N %V - Articles in | | | | feed '%T' (%u unread, | | | | %t total)%?F? | | | | matching filter | | | | '%F'&? - %U | +----------------------------+---------------------------+-----------------------+ | | searchresult-title-format | %N %V - Search | | | | results for '%s' (%u | | | | unread, %t total)%?F? | | | | matching filter | | | | '%F'&? | +----------------------------+---------------------------+-----------------------+ | | filebrowser-title-format | %N %V - %?O?Open | | | | File&Save File? - %f | +----------------------------+---------------------------+-----------------------+ | | dirbrowser-title-format | %N %V - %?O?Open | | | | Directory&Save File? | | | | - %f | +----------------------------+---------------------------+-----------------------+ | | help-title-format | %N %V - Help | +----------------------------+---------------------------+-----------------------+ | | selecttag-title-format | %N %V - Select Tag | | | | | | | | | +----------------------------+---------------------------+-----------------------+ | | selectfilter-title-format | %N %V - Select Filter | | | | | | | | | +----------------------------+---------------------------+-----------------------+ | | itemview-title-format | %N %V - Article '%T' | | | | (%u unread, %t total) | +----------------------------+---------------------------+-----------------------+ | | urlview-title-format | %N %V - URLs | | | | | +----------------------------+---------------------------+-----------------------+ | | dialogs-title-format | %N %V - Dialogs | | | | | | | | | +----------------------------+---------------------------+-----------------------+ . +----------------+-------------------------+ | | | +----------------+-------------------------+ |N | | | | | | | "Newsboat" | +----------------+-------------------------+ |V | | | | | +----------------+-------------------------+ . +----------------+-----------------------------------+ | | | +----------------+-----------------------------------+ |T | | | | | | | ( | | | | | | | | | | | | ) | +----------------+-----------------------------------+ |t | | | | | +----------------+-----------------------------------+ |u | | | | | | | | +----------------+-----------------------------------+ |U | | | | | | | | +----------------+-----------------------------------+ |F | | | | ( | | | | | | | | | ) | +----------------+-----------------------------------+ . +----------------+-----------------------------------+ | | | +----------------+-----------------------------------+ |T | | +----------------+-----------------------------------+ |U | URL | | | | +----------------+-----------------------------------+ |u | | | | | | | | +----------------+-----------------------------------+ |t | | | | | +----------------+-----------------------------------+ |F | | | | ( | | | | | | | | | ) | +----------------+-----------------------------------+ . +---------------------------+-----------------+ | | | +---------------------------+-----------------+ |s | | | | | +---------------------------+-----------------+ | | | | | | | | | | | | |articlelist-title-format | | | | | | | | |( | | | ) | | +---------------------------+-----------------+ . +----------------+---------------------------+ | | | +----------------+---------------------------+ |f | | +----------------+---------------------------+ |O | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | +----------------+---------------------------+ . +----------------+-----------------------------+ | | | +----------------+-----------------------------+ |f | | +----------------+-----------------------------+ |O | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | +----------------+-----------------------------+ . +----------------+-----------------------------------+ | | | +----------------+-----------------------------------+ |T | | +----------------+-----------------------------------+ |F | | +----------------+-----------------------------------+ |u | | | | | | | | +----------------+-----------------------------------+ |t | | | | | +----------------+-----------------------------------+ (TAGGING) "" RSS . RSS . RSS . . urls URL RSS . RSS (space) (tab) . (") ( ). urls : https://blog.fefe.de/rss.xml?html interesting conspiracy news "cool stuff" https://rss.orf.at/news.xml news orf https://www.heise.de/newsticker/heise.rdf news interesting T . "news" RSS . T "conspiracy" RSS . Ctrl + T RSS . (~) . ( ~) . " " (first tag) . : https://rss.orf.at/news.xml "~ORF News" (!) . . https://rss.orf.at/news.xml ! news http://feeds.bbci.co.uk/news/world/rss.xml ! news "query:News from around the globe:tags # \"news\"" "News from around the globe" . "" . (SCRIPTS AND FILTERS) Snownews . RSS Snownews Liferea . "execurl" "filter" . "execurl" RSS "filter" URL RSS . . urls : exec:~/bin/execurl-script filter:~/bin/filter-script:https://some.test/url execurl : exec: . ( ): "exec:~/bin/execurl-script param1 param2" : filter: (:) URL . : "filter:~/bin/filter-script param1 param2:https://url/foobar" : exec:~/bin/execurl-script tag1 tag2 "quoted tag" filter:~/bin/filter-script:https://some.test/url tag3 tag4 tag5 . . exec RSS . . doc/examples . (KILLFILES) . (Usenet) "killfile" ( ) . . ignore-article : ignore-article "https://synflood.at/blog/index.php?/feeds/index.rss2" "title =~ \"newsboat\"" ignore-article "regex:https?://nitter.net/.*" "title =~ \"^RT by\"" ignore-article "*" "title =~ \"Gentoo\"" . : o URL . o regex:. POSIX . o "*" ( glob -- " " ). . RSS . ignore-article . . : o : () . o : . : (undo) . ignore-article . "download" . ignore-mode : ignore-mode "display" (PODCAST SUPPORT) RSS . () . "" . RSS "enclosures" () . RSS . . RSS . (Remote APIs) "" . API . (issue) ! (COMMAND LINE) (ad hoc) . . : . ":" vi(m) mutt. . Enter ( ) . Esc . history.cmdline cache.db . history-limit . history-limit 0 . . Tab . Tab . . set . Ctrl + G ( ) Ctrl + K ( ) Ctrl + U ( ) Ctrl + W ( ) . history.cmdline history.search ( cache.db) . ( history-limit) ( 0). : quit . q quit. save . set [=|&|!] ( ) . ! (toggle) & . tag . goto . source [...] . . dumpconfig . . (FILES) "dotdir" ( ) ~/.newsboat. XDG : 1. $XDG_CONFIG_HOME/newsboat/ ( XDG_CONFIG_HOME ~/.config ) 2. $XDG_DATA_HOME/newsboat/ ( XDG_DATA_HOME ~/.local/share ) newsboat XDG_CONFIG_HOME XDG ( ). ~/.newsboat . ~/.newsboat/ XDG : config urls $XDG_CONFIG_HOME/newsboat/ cache.db history.search history.cmdline queue $XDG_DATA_HOME/newsboat/ " " (lock files) . . -- cache.db queue . : +---------+---------------------------+---------------------------------------+ | | | XDG | | | | | | | (dotdir) | | +---------+---------------------------+---------------------------------------+ |Newsboat | ~/.newsboat/cache.db.lock | $XDG_DATA_HOME/newsboat/cache.db.lock | +---------+---------------------------+---------------------------------------+ |Podboat | ~/.newsboat/pb-lock.pid | $XDG_DATA_HOME/newsboat/.lock | +---------+---------------------------+---------------------------------------+ () cache-file --cache-file . --lock-file . (dotfiles) ~/.newsboat/config ~/.newsboat/urls XDG $XDG_CONFIG_HOME/newsboat/config $XDG_CONFIG_HOME/newsboat/urls : XDG_CONFIG_HOME ~/.config . (ENVIRONMENT) BROWSER browser . lynx(1) . CURL_CA_BUNDLE (peer) . . () PEM . libcurl . EDITOR urls edit-urls VISUAL . vi(1) . NO_PROXY proxy . IP . "example.com" "foo.example.com" . ".example.com" "bar.example.com" "example.com" . IPv6 . "::1" "::0:1" . PAGER pager (pager) . TMPDIR . /tmp . VISUAL urls edit-urls . EDITOR . XDG_CONFIG_HOME . . XDG_DATA_HOME . . (SEE ALSO) podboat(1) (AUTHOR) Alexander Batischev 2026-06-21 NEWSBOAT(1)