cleanup and add README

README.md

@@ -0,0 +1,43 @@
+### Miniflux old feed fetcher
+
+Some news sites pay-wall articles for some time such that they are only
+available to subscribers. After the pay-wall period, they are then freely
+available to all. This script is for [lwn][0].
+
+1. Gets all articles before last Thursday that were pay-walled. Title starts
+   with `[$] ...` for pay-walled articles
+2. Downloads full content
+3. Updates title replacing `$` with `✓`, i.e Now it reads `[✓] ...`
+4. Marks those articles as unread
+
+### Dependencies
+
+* [yq][1]
+* [miller][2]
+
+### Usage
+
+1. Update miniflux url and feed id
+2. export MINIFLUX_TOKEN environment variable
+3. Run `./run.sh`
+
+```sh
+❯ ./run.sh
+Considering articles between w2: 2025-06-08T13:47:04-04:00 and w1: 2025-06-19T00:00:00-04:00
+processing entry: 3068 title: [$] Finding locking bugs with Smatch
+Downloding content. entry: 3068 title: [$] Finding locking bugs with Smatch
+Updating title. entry: 3068 title: [$] Finding locking bugs with Smatch
+Marking as unread. entry: 3068 title: [$] Finding locking bugs with Smatch
+processing entry: 3061 title: [$] Improving iov_iter
+Downloding content. entry: 3061 title: [$] Improving iov_iter
+Updating title. entry: 3061 title: [$] Improving iov_iter
+Marking as unread. entry: 3061 title: [$] Improving iov_iter
+processing entry: 3060 title: [$] An end to uniprocessor configurations
+Downloding content. entry: 3060 title: [$] An end to uniprocessor configurations
+Updating title. entry: 3060 title: [$] An end to uniprocessor configurations
+Marking as unread. entry: 3060 title: [$] An end to uniprocessor configurations
+```
+
+[0]: https://lwn.net
+[1]: https://github.com/mikefarah/yq
+[2]: https://github.com/johnkerl/miller