lk/data/newsboat.md

75 lines
1.8 KiB
Markdown
Raw Normal View History

2022-11-28 23:17:12 +00:00
---
title: "newsboat"
tags: [ "Documentation", "RSS" ]
---
Create the configuration directory before you start, and add at least 1 URL.
```bash
mkdir ~/.config/newsboat
```
2022-11-28 23:17:12 +00:00
```bash
echo 'https://voidlinux.org/atom.xml foss tech' >> ~/.config/newsboat/urls
```
2022-11-28 23:17:12 +00:00
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:
```bash
curl *'https://www.youtube.com/@1minfilms'* | grep -oE 'browseId":"U\w+"' | tail | cut -d'"' -f3
```
2022-11-28 23:17:12 +00:00
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