FEAD(1)

💅 FEAD(1) — like, the fead manual page, bestie

okay so first things first: the command is fead, it lives in the User Commands section of the manual, and it is literally an advert generator that eats web feeds for breakfast. no cap. 🦋

---

✨ NAME ✨

fead — advert generator from web feeds 🌸

🎀 SYNOPSIS 🎀

fead [OPTION]...

🫶 DESCRIPTION 🫶

Generate adverts from web feeds. that's the whole vibe. you give it feeds, it gives you ads. iconic behavior honestly 👑

💅 OPTIONS 💅

• -h, --help — shows this help message and then exits, like a polite queen 🎀
• -v, --version — shows the program's version number and then exits 👑
• -F, --feeds PATH — a file containing newline-separated web feed URLs (one URL per line, slay) 📄
• -f, --feed URL — an additional web feed URL; you can use this one multiple times, so stack 'em up 🧚
• -s, --strict — abort the whole thing when it fails to fetch or parse a web feed. no silent failures, we die with dignity 💀
• -n, --count N — the maximum number of ads in total (defaults to 3)
• -p, --per-feed N — the maximum number of ads per feed (defaults to 1)
• -l, --length N — the maximum summary length (defaults to 256)
• -t, --template PATH — the template file (defaults to stdin)
• -o, --output PATH — the output file (defaults to stdout)

🚨 lowkey important: any use of -f before -F is ignored. order matters, bestie, -F first or it's giving nothing.

⭐ TEMPLATE ⭐

the template gets used by Python str.format to generate each advert. it can contain the following fields, and they're delimited by braces ({ and }) — so yes, curly braces, not vibes 🎀

• source_title — the title of the web feed
• source_link — the URL to the feed's website
• title — the title of the feed item
• link — the URL to the item
• time — the publication time
• summary — the truncated content or description

and about that publication time: it's a Python datetime.datetime object, which supports at least C89 format codes, e.g. {time:%Y-%m-%d}. so you can format it however you want, periodt 🕐✨

🌈 EXAMPLES 🌈

okay so given these URLs in a feeds file:

https://adol.pw/index.xml
https://cnx.gdn/feed.xml
https://xrvs.net/index.xml

you can generate an advertisement of the two latest blogs among them, along with articles by Drew DeVault, via the following command. it's giving main character energy fr fr:

echo "<article>
  <h3><a href='{link}'>{title}</a></h3>
  {summary}&mdash;<a href='{source_link}'>{source_title}</a>,
{time:%F}
  </article>" | fead -F feeds -f https://drewdevault.com/blog/index.xml
-n 2

😭 REPORTING BUGS 😭

issues should be reported to <~cnx/misc@lists.sr.ht>. don't suffer in silence, tell the maintainers 🫶

🦋 SEE ALSO 🦋

python(1), strftime(3)

---

and that's the whole page 💖 this was fead version 1.0.0, dated January 1980 (yes really, that date is not a typo, it's just vintage ✨). mwah, go generate some ads 🎀🔥