comitium

comitium is a Gemini feed aggregator that supports Atom, RSS, JSON, and Gemini feeds, as well as tracking page changes. Inspired by gmisub, Lagrange’s built-in feeds, gemreader and many others.

Comitium means “gathering” or “assembly” in latin.

usage

See comitium help for basic usage. For more advanced usage, see comitium(1) and the quickstart page.

why another aggregator?

There's many gemini aggregators out there, and yet not one does everything I want it to. I want an aggregator that:

1. works with gemini (and possibly gopher & http)
2. supports atom (and possibly rss & json)
3. supports gemini feeds
4. can watch for page changes (and possibly watch for new gemtext headers as well)
5. 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.

All of the aggregators always have really cool features (that I may or may not even use) and yet all (that I've found) don't meet one or more of these criterion. Hence, going and writing my own.

building

Dependencies:

• go (module-aware)
• scdoc

Then do the standard:

$ 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 non–git-repo.

contributing

Send patches and issue reports to [~nytpu/public-inbox@lists.sr.ht][mailto:~nytpu/public-inbox@lists.sr.ht]

license

comitium is Copyright © 2021 nytpu.

comitium is licensed under the terms of the GNU Affero General Public License, either version 3 of the License, or (at your option) any later version. For more information, see LICENSE or the GNU website

comitium uses the go-gemini, gofeed, and go-homedir libraries, all of which are covered under the terms of the MIT License]. It also uses the pflag library, which is licensed terms of the BSD 3-Clause License.