SFEED_GOPHER(1)

📦
version 2.4 · 3 versions
, in alpine 3.24, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 SFEED_GOPHER — the manual, but make it cute 💖

okay bestie, welcome to sfeed_gopher, section 1 of the General Commands Manual. this is the lil tool that takes your feed data and turns it into Gopher files ✨ pull up a chair, we're doing this together 🫶

🌸 NAME 🌸

sfeed_gopher — format feed data to Gopher files 💅

✨ SYNOPSIS ✨

sfeed_gopher [file ...]

🦋 DESCRIPTION 🦋

so here's the tea, bestie: sfeed_gopher formats feed data (that's TSV, from sfeed(1)) from stdin, or for each file, and writes it out to stdout in the raw Gopher output format. iconic behaviour honestly 💖

  • if you pass one or more file arguments, then the basename of the file is used as the feed name in the output. sfeed_gopher creates an index file named "index" and, for each feed, it creates a file with the same name as the basename of the feed file. one file per feed, no crumbs left behind 🧚
  • if you pass no file arguments — so the data comes in from stdin — then the data just goes to stdout and no files are written. zero. none. nada. 🙈

items whose timestamp falls within the last day compared to the system time at the moment of formatting get counted and marked as new. that value can be overridden with environment variables (more on that below, keep reading bestie 👀). new items get marked with the prefix "N" at the start of the line. and if an index file is in play, then feeds with new items are marked as new too, with that same "N" prefix at the start of the line. cute, consistent, slay 💅

🎀 ENVIRONMENT 🎀

  • SFEED_GOPHER_PATH — use this as the prefix for each path in the index file. the default is "/". ✨
  • SFEED_GOPHER_HOST — use this as the Gopher Host field. the default is "127.0.0.1". lowkey the local bestie 🏠
  • SFEED_GOPHER_PORT — use this as the Gopher Port field. the default is "70". classic 💫
  • SFEED_NEW_AGE — overwrite the maximum age in seconds for marking feeds as new. by default it's 86400, which equals one day. no cap ⏰

💀 EXIT STATUS 💀

sfeed_gopher exits 0 on success, and >0 if an error occurs. simple as. if it's not 0, something went wrong bestie 😭

🔥 EXAMPLES 🔥

here's the moment you've been waiting for, the main character energy example:

SFEED_GOPHER_HOST="codemadness.org" SFEED_GOPHER_PATH="/feeds/" \
        sfeed_gopher ~/.sfeed/feeds/*

look at her go. obsessed. 👑

🌈 SEE ALSO 🌈

⭐ STANDARDS ⭐

The Internet Gopher Protocol, RFC 1436, March 1993. vintage but make it timeless 🦋

👑 AUTHORS 👑

Hiltjo Posthuma <hiltjo@codemadness.org> — thank you for your service, legend 🫶

🍓 CAVEATS 🍓

ngl, this one matters: the commonly-used 'h' and 'i' types are used in this program. those types are an extension to Gopher — so, like, technically not vanilla Gopher. just so you know, bestie 💅

and that's the whole page, fr fr 💖 this was the SFEED_GOPHER(1) manual from the Debian crew, dated September 21, 2025. go forth and gopher, queen 🎀✨

📦 where this page comes from