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)