rss email digests over ssh because you're a cool kid
herald.dunkirk.sh
go
rss
rss-reader
ssh
charm
docs: update readme with image
+9
-7
+9
-7
README.md
+9
-7
README.md
···
1
1
# Herald 🎏
2
2
3
+
4
+
3
5
This was inspired by the sunsetting of [pico.sh/feeds](https://blog.pico.sh/ann-033-moving-rss-to-email-pico-plus) being available outside of `pico+`. It is a totally understandable move from them as their email costs were skyrocketing and they needed to pay for it somehow. This was created to allow me to still get my rss feeds delivered to me each day by email which I have grown quite accustomed to. The config is completely compatible with the `pico.sh` format as of `2026-01-09` and should stay fairly stable. It is also configured over ssh with the slight addition that you can view your feeds on a website as well as I found myself wanting to hot load my feeds into my website :)
4
6
5
7
The canonical repo for this is hosted on tangled over at [`dunkirk.sh/herald`](https://tangled.org/@dunkirk.sh/herald)
···
27
29
=: email you@example.com
28
30
=: cron 0 8 * * *
29
31
=: digest true
30
-
=> https://blog.example.com/rss
32
+
=> https://dunkirk.sh/atom.xml
31
33
=> https://news.ycombinator.com/rss
32
34
=> https://lobste.rs/rss "Lobsters"
33
35
```
···
35
37
Upload via SCP:
36
38
37
39
```bash
38
-
scp feeds.txt user@herald.example.com:
40
+
scp feeds.txt user@herald.dunkirk.sh:
39
41
```
40
42
41
43
### SSH Commands
42
44
43
45
```bash
44
46
# List your configs
45
-
ssh herald.example.com ls
47
+
ssh herald.dunkirk.sh ls
46
48
47
49
# Show config contents
48
-
ssh herald.example.com cat feeds.txt
50
+
ssh herald.dunkirk.sh cat feeds.txt
49
51
50
52
# Delete a config
51
-
ssh herald.example.com rm feeds.txt
53
+
ssh herald.dunkirk.sh rm feeds.txt
52
54
53
55
# Run immediately (don't wait for cron)
54
-
ssh herald.example.com run feeds.txt
56
+
ssh herald.dunkirk.sh run feeds.txt
55
57
56
58
# Show recent activity
57
-
ssh herald.example.com logs
59
+
ssh herald.dunkirk.sh logs
58
60
```
59
61
60
62
### Web Interface