~callum/gmsfn

A feed builder for Gemini

eeffc0a Link to mailing list and bug tracker in README

~callum pushed to ~callum/gmsfn git

13 days ago

#2 Add option to only link to files served over Gemini

~callum filed ticket on gmsfn todo

14 days ago

NOTE: This markdown version of the README has been adapted from the Gemtext version so that sr.ht has something to display.

#gmsfn

gmsfn is a program used to update a file with new links found in Gemtext pages served over the Gemini protocol. I wrote it partly because I wanted something a bit different to CAPCOM and spacewalk, and partly to learn C through a real project. The name comes from the Manned Space Flight Network (MSFN), which was a set of tracking stations used to support the Gemini space program (as well as Mercury, Apollo and Skylab).

Differences from CAPCOM and spacewalk:

  • Doesn't rely on authors to provide an Atom feed
  • Links directly to posts
  • Feeds are configured in a file, not by a CLI
  • Feeds will probably include links you don't want to see, like links back to a home page or to an Atom/RSS feed.
  • Doesn't detect if textual content of a page changes

All the hard work to do with Gemini and parsing Gemtext is done using Drew Devault's gmni, which is currently vendored in with gmsfn (it's not yet been made into a library). Thank you Drew!

#Example

A live feed (updated daily) and the configuration for it can be found at:

#Installation

Dependencies:

  • A POSIX-like system and a C11 compiler
  • OpenSSL
  • scdoc
$ git clone https://git.sr.ht/~callum/gmsfn
$ cd gmsfn
$ make
# make install

#Usage

For more information about how gmsfn works see the man pages:

#Mailing list and bug tracker

Mail patches and discussion to: ~callum/gmsfn@lists.sr.ht