SFEED_MARKREAD(1)

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

πŸ’– SFEED_MARKREAD β€” bestie edition πŸ’–

okay so this is a page from the General Commands Manual, section 1, and it's about the iconic little utility sfeed_markread. no cap, it's a whole vibe.


✨ NAME ✨

sfeed_markread β€” mark items as read / unread πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

sfeed_markread read | unread [urlfile]

like. that's it. that's the whole thing. she's simple, she's elegant, she slays πŸ’…


🌸 DESCRIPTION 🌸

so sfeed_markread reads a plain-text list of URLs from stdin. that's the tea. β˜•

the file format for that list of URLs is literally just one URL per line. one. per. line. don't overthink it, bestie, it's giving minimalism ✨

then sfeed_markread writes to the file you specified as urlfile, or to the file named by the environment variable SFEED_URL_FILE. pick your fighter, either works 🫢

and the reason this whole thing exists? the sfeed_markread script can be used by sfeed_curses(1) to mark items as read and unread. so like, it's the little helper that keeps your feed app's read-state in check. main character support role, honestly πŸ‘‘


πŸŽ€ ENVIRONMENT VARIABLES πŸŽ€

  • SFEED_URL_FILE β€” set this bad boy to use as the path to the file containing a plain-text list of read URLs. it's the default destination when you don't hand over a urlfile yourself πŸ’–

πŸ’€ EXIT STATUS πŸ’€

the sfeed_markread utility exits 0 on success, and >0 if an error occurs.

so like β€” 0? we ate, no crumbs, perfection ✨. anything bigger than 0? something went sideways and we're crying in the club 😭


🌈 EXAMPLES 🌈

example numero uno, using the environment variable:

export SFEED_URL_FILE="$HOME/.sfeed/urls"
echo 'https://codemadness.org/sfeed.html' | sfeed_markread read

or, if you'd rather pass the urlfile as a parameter (valid, iconic, respected):

echo 'https://codemadness.org/sfeed.html' | sfeed_markread read ~/.sfeed/urls

see how both do the exact same thing? yeah. choose the one that matches your aesthetic πŸ’…


πŸ‘‘ SEE ALSO πŸ‘‘

awk(1), sfeed_curses(1)

go read those too, bestie, they're literally right there πŸ¦‹


πŸ’œ AUTHORS πŸ’œ

Hiltjo Posthuma <hiltjo@codemadness.org>


fr fr, that's the whole page. go forth and mark things as read. iykyk πŸ“

and a lil sign-off for the record: this page came from the Debian packaging, dated October 27, 2024. slay, periodt. πŸ’…βœ¨πŸŒΈ

πŸ“¦ where this page comes from