---
title: "newsboat"
tags: [ "Documentation", "RSS" ]
---
Create the configuration directory before you start, and add at least 1 URL.

> mkdir ~/.config/newsboat

> echo 'https://voidlinux.org/atom.xml foss tech' >> ~/.config/newsboat/urls

Start `newsobat` and press `r` to load your feed.

To add a feed, you can press `E` to edit that `urls` file.

## Examples of Feeds

`https://www.schneier.com/feed/atom/ infosec news`

The words after the URL - `infosec news` - becomes tags.

You can input a Youtube channel by adding this, with the channel's ID at the end:

`https://www.youtube.com/feeds/videos.xml?channel_id=UCbbsW7_Esx8QZ8PgJ13pGxw vids #1MinFilms`

To get the channel ID without hunting:

> curl *'https://www.youtube.com/@1minfilms'* | grep -oE 'browseId":"U\w+"' | tail | cut -d'"' -f3 

You can add arbitrary commands to get an RSS feed.
For example, to get a Gemini feed, install `gemget`, then put this in the configuration file:

`"exec:gemget gemini://alexschroeder.ch:1965/do/blog/rss --output -" gemini rpg`

All gits can be used as RSS feeds:

`https://github.com/isamert/scli/commits/master.atom`

## Commands

- `E` to edit the URLs file
- `R` to reload everything
- `t` to browse by tags
- `n` to mark an item as read
- Ctrl + a to mark everything in a feed as read

## Configuration Options

You can use a macro by pressing comma, then a key.
With this one, you press comma + v to see a video:

`macro v set browser "mpv --ytdl-format=mp4 %u &>/dev/null&"; open-in-browser-and-mark-read`

(this needs `mpv` and `yt-dlp` installed)

Or or `,o` to open an article in w3m:

`macro o set browser "w3m %u"; open-in-browser-and-mark-read ; set browser "w3m %u"`

Add vim-like keys:

```
bind-key j next
bind-key k prev
bind-key j down article
bind-key k up article
```