# newsboat Cheatsheet - Cheatsheets - Launch Pad

__ _______________________ _________._________________________ \_ _____/ \______ \ / _ \ / _____/ / _____/ | | \_ _____/ | __) | _/ / /_\ \ / \ ___ / \ ___ | | | __)_ | \ | | \ / | \ \ \_\ \ \ \_\ \ | |___ | \ \___ / |____|_ / \____|__ / \______ / \______ / |_______ \ /_______ / \/ \/ \/ \/ \/ \/ \/

# newsboat Cheatsheet

← Back to cheatsheets

← Home

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)

← Back to cheatsheets

← Home