GARY IS COMING FOR YOU

You shouldn't have done that.

⚙ MALEVELON CREEK
CLICK TO SCAN
SPACE-BAR SERVICE DESK

Bartender

Here to help you explore

Questions and relevant page context are sent to TypeSafe. Questions Bartender cannot answer are saved to improve the site, without your account or IP. Other conversation stays in this tab.

Pages · Linux · Games · Radio · Weather · Pokémon

newsboat Tool Reference

newsboat is a text-based RSS/Atom feed reader for the terminal.

Feed List View

  • j or ↓ - Move down
  • k or ↑ - Move up
  • Enter - Open selected feed
  • r - Reload selected feed
  • R - Reload all feeds
  • ^R (Ctrl+R) - Reload all feeds
  • / - Search feeds
  • q - Quit or go back
  • ? - Show help

Article List View

  • j or ↓ - Move down
  • k or ↑ - Move up
  • Enter - Open selected article
  • o - Open article in browser
  • O - Open article in browser and mark as read
  • u - Show URLs in article
  • 1-0 - Open URL number 1-10 directly
  • s - Toggle read/unread status
  • t - Toggle headline display mode
  • g - Go to top of list
  • G - Go to bottom of list
  • / - Search articles
  • : - Command prompt
  • q - Quit or go back

Article View

  • j or ↓ - Scroll down
  • k or ↑ - Scroll up
  • o - Open article in browser
  • O - Open article in browser and mark as read
  • u - Show URLs in article
  • 1-0 - Open URL number 1-10 directly
  • s - Toggle read/unread status
  • n - Next unread article
  • p - Previous unread article
  • / - Search in article
  • q - Quit or go back

Configuration

Config File Location

  • ~/.config/newsboat/config (user config, XDG)
  • ~/.newsboat/config (legacy location)
  • ~/.config/newsboat/urls (feed list)
  • ~/.newsboat/urls (legacy feed list)

Example Key Bindings

Customize key bindings in config:

# Reload feeds
bind-key R reload-all
bind-key ^R reload-all

# Navigation
bind-key j down
bind-key k up
bind-key o open

# Article operations
bind-key O open-in-browser-and-mark-read
bind-key s toggle-article-read

# Browser command
browser "firefox %u"

Common Settings

# Display options
show-read-feeds no
show-read-articles no
articlelist-format "%4i %f %D %-20T %>S %u"

# Behavior
auto-reload yes
reload-time 60
max-items 100

# External commands
browser "firefox %u"
pager "less"

Tips

  • Use XDG directories: config and urls in ~/.config/newsboat/
  • Data files (cache.db, history.search) stored in ~/.local/share/newsboat/
  • Supports OPML import/export for feed management
  • Use macros for complex operations
  • Per-dialog key bindings supported
  • Comments in config start with #
  • Use bind or bind-key commands (both work)