comitium is a Gemini, Gopher, and HTTP feed aggregator that supports Atom, RSS, JSON, and Gemini feeds, as well as tracking page changes, which is output into a simple static Gemini document that you can put anywhere.
You can see a running instance in action at gemini://nytpu.com/feed.gmi.
There are many Gemini aggregators out there, and yet not one does everything I want it to. I want an aggregator that:
- Works with Gemini and Gopher (and possibly http)
- Supports Atom, RSS, and Gemini feeds (and possibly JSON feeds)
- Can watch a page for changes
- Simple and easy setup & usage
All of the aggregators always have really cool and unique features, and yet all that I've found don't meet one or more of these basic (IMO) criterion. Hence, going and writing my own.
Also, it's nice if it doesn't tie me to a specific browser/service; i.e. trivially self-hostable, ideally as CGI or static pages that can use an existing server setup rather than needing vhosting and routes.
comitium help for basic usage. For more detailed usage, see
To get up and running, see the quickstart page.
You can download prebuilt x86-64 binaries for Linux, FreeBSD, and Mac:
- comitium v1.5.2 Linux — GPG Signature
- comitium v1.5.2 FreeBSD — GPG Signature
- comitium v1.5.2 Mac — GPG Signature
- go (module-aware)
Then do the standard:
$ git clone git://git.nytpu.com/comitium # you could also download a tarball $ cd comitium $ make # make install
A note to packagers (yes, I'm ambitious aren't I?): make sure to build with
make COMMIT=tarball, otherwise there will be an issue when building in a
comitium took inspiration and small code snippets from:
- Amfora — how to structure saving subscriptions to JSON and refreshing subscriptions with goroutines.
- gemreader — simple Gemini feed parsing.
comitium gratefully makes use of the following libre libraries:
- go-gemini for fetching Gemini resources.
- go-gopher for fetching Gopher resources.
- gofeed for parsing Atom, RSS, and JSON feeds.
- pflag for parsing flags and arguments.
- go-homedir for locating configuration directories.
comitium is Copyright © 2021 nytpu.
Comitium means “gathering” or “assembly” in Latin.
together stuff from all protocols into one centralized place. Blah blah blah,
you get the picture.