SFEED_UPDATE(1)

πŸ“¦
version 2.4 Β· 3 versions
, in alpine 3.24, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ sfeed_update(1) ✨

okay bestie, so this is sfeed_update from the General Commands Manual section, and it's literally the glow-up your feed reader deserves πŸ’…


🌸 NAME 🌸

sfeed_update β€” update feeds and merge with old feeds


πŸ¦‹ SYNOPSIS πŸ¦‹

sfeed_update [sfeedrc]

πŸ’– DESCRIPTION πŸ’–

sfeed_update writes TAB-separated feed files and merges new items with the items in any existing files. no cap, it's giving "fresh items, same cozy home" 🏠✨

The items are stored as one file per feed in the directory $HOME/.sfeed/feeds by default. You can change that directory in the sfeedrc(5) file, so go off, customize your little corner of the internet πŸŽ€


πŸ‘‘ OPTIONS πŸ‘‘

  • sfeedrc β€” Config file. The default is $HOME/.sfeed/sfeedrc. yes, it's optional, it has a default, it's low maintenance, we love that for it πŸ’œ

πŸ“– FILES READ πŸ“–

  • sfeedrc β€” This file is evaluated as a shellscript inside sfeed_update. See also the sfeedrc(5) man page for a detailed description of the format and an example file. she's not just a config, she's a whole script, main character energy fr fr 🫢

πŸ“ FILES WRITTEN πŸ“

  • feedname β€” TAB-separated sfeed(5) format containing all items per feed. The sfeed_update script merges new items with this file. so it doesn't overwrite your babies, it merges them, iconic behavior honestly πŸ˜­πŸ’–

🌈 ENVIRONMENT VARIABLES 🌈

  • SFEED_UPDATE_INCLUDE β€” When set to "1" sfeed_update can be sourced as a script, but it won't run the main() entry-point. it's like, "bestie I'm here but I'm not gonna take over the party" πŸ™ˆ

πŸ“ LOGGING πŸ“

When processing a feed it will log failures to stderr and non-failures to stdout in the format:

[HH:MM:SS] feedname message

so you always know who's thriving and who's not πŸ•βœ¨


πŸ’€ EXIT STATUS πŸ’€

The sfeed_update utility exits 0 on success, and >0 if an error occurs. If any of the feeds failed to update then the exit status is non-zero. one sad feed and the whole thing is sad, that's just the vibe check 🌧️


πŸŽ€ EXAMPLES πŸŽ€

To update your feeds and format them in various formats:

# Update feeds
sfeed_update "configfile"
# Format to a plain-text list
sfeed_plain ~/.sfeed/feeds/* > ~/.sfeed/feeds.txt
# Format to HTML
sfeed_html ~/.sfeed/feeds/* > ~/.sfeed/feeds.html
# Format to HTML with frames
mkdir -p somedir && cd somedir && sfeed_frames ~/.sfeed/feeds/*

look at that pipeline, she ate and left no crumbs πŸ”₯


🧚 SEE ALSO 🧚

sfeed(1), sfeed_frames(1), sfeed_html(1), sfeed_plain(1), sh(1), sfeed(5), sfeedrc(5)

the whole squad, all invited to the function ⭐


πŸ’œ AUTHORS πŸ’œ

Hiltjo Posthuma <hiltjo@codemadness.org>


psst, this page came from the Debian peeps, dated October 27, 2024 β€” SFEED_UPDATE(1), that's the whole thing bestie, go update your feeds and slay πŸ’…βœ¨
πŸ“¦ where this page comes from