2020-08-21 08:07:37 +00:00
# Awesome Gemini [![Awesome](https://awesome.re/badge-flat.svg)](https://awesome.re)
2020-08-21 07:54:14 +00:00
A collection of awesome things regarding the [gemini protocol][1] ecosystem.
Please contribute to this list to link to all the awesome gemini projects out there.
2020-08-22 18:20:56 +00:00
## What is Gemini
[Excerpt from gemini.circumlunar.space ](https://gemini.circumlunar.space/docs/specification.html ):
> Gemini is a client-server protocol featuring request-response transactions, broadly similar to gopher or HTTP.
2020-11-20 07:40:25 +00:00
Connections are closed at the end of a single transaction and cannot be reused. When Gemini is served over TCP/IP, servers
2020-08-22 18:20:56 +00:00
should listen on port 1965 (the first manned Gemini mission, Gemini 3, flew in March'65).
This is an unprivileged port, so it's very easy to run a server as a "nobody" user, even if e.g. the server is written
in Go and so can't drop privileges in the traditional fashion.
2020-08-21 07:54:14 +00:00
## Contents
- [Clients ](#clients )
- [Terminal ](#terminal )
- [Graphical ](#graphical )
2020-08-28 06:37:01 +00:00
- [Cross-platform ](#cross-platform )
- [Mobile ](#mobile )
- [Windows ](#windows )
2020-08-21 07:54:14 +00:00
- [Programming ](#programming )
2020-08-22 18:20:56 +00:00
- [Resources ](#resources )
2020-08-21 07:54:14 +00:00
- [Servers ](#servers )
2020-11-27 08:43:06 +00:00
- [Services ](#services )
2020-08-21 07:54:14 +00:00
- [Tools ](#tools )
- [Web proxies ](#web-proxies )
## Clients
### Terminal
2020-08-25 20:22:04 +00:00
- [Amfora ](https://github.com/makeworld-the-better-one/amfora ) (Go) - a "fancy" terminal client.
2020-11-06 21:26:25 +00:00
- [Asuka ](https://git.sr.ht/~julienxx/asuka ) (Rust) - an NCurses-based Gemini client.
2020-08-25 20:22:04 +00:00
- [AV-98 ](https://tildegit.org/solderpunk/AV-98 ) (Python) - a Gemini client derived from the popular VF-1 Gopher client.
- [bollux ](https://sr.ht/~acdw/bollux/ ) (Bash) - a bash Gemini client.
2020-12-02 18:42:15 +00:00
- [bombadillo ](https://rawtext.club/~sloum/bombadillo.html ) (Go) - a combined Gopher, Gemini, Finger, and File client with vim-inspired key mappings.
2020-09-07 05:51:05 +00:00
- [diohsc ](https://mbays.sdf.org/diohsc/ ) (Haskell) - a simple line-based command-response terminal user interface with ANSI colour.
2020-08-25 20:22:04 +00:00
- [Elpher ](https://thelambdalab.xyz/elpher/ ) (Emacs) - a combined Gopher and Gemini client for the popular text editor / operating system.
2020-09-07 05:58:19 +00:00
- [gemini-demo-1 ](https://tildegit.org/solderpunk/gemini-demo-1 ) (Python) - a minimal but usable interactive Gemini client in < 100 LOC of Python 3 .
2020-09-07 05:59:53 +00:00
- [gemini-demo-2 ](https://tildegit.org/solderpunk/gemini-demo-2 ) (Lua) - a minimal but usable interactive Gemini client in < 100 LOC of Lua .
2020-09-07 06:02:45 +00:00
- [gemini-demo-3 ](https://tildegit.org/solderpunk/gemini-demo-3 ) (Go) - a minimal but usable interactive Gemini client in not quite < 100 LOC of Go .
2020-08-25 20:22:04 +00:00
- [gemini-fetch ](https://github.com/RangerMauve/gemini-fetch ) (Node.js) - a cURL-like CLI for loading content from Gemini URLs.
2020-09-29 00:28:18 +00:00
- [gmni ](https://sr.ht/~sircmpwn/gmni/ ) (C) - a CLI utility (like curl) and a line-mode browser.
2020-09-19 09:18:33 +00:00
- [min ](https://github.com/a-h/min ) (Go) - supports advanced features like input and client certificate generation.
2020-08-21 07:54:14 +00:00
### Graphical
2020-08-27 20:08:37 +00:00
#### Cross-platform
2020-08-25 20:22:04 +00:00
- [Agregore ](https://github.com/RangerMauve/agregore-browser#fetch-api-for-gemini ) - (Electron.js) - a peer to peer web browser with support for loading Gemini pages.
- [Alrisha ](https://git.sr.ht/~fabrixxm/alrisha ) (QML) - QML-based Gemini client.
- [Castor ](https://git.sr.ht/~julienxx/castor ) (Rust) - a graphical Gemini client using GTK.
- [Fafi ](https://git.sr.ht/~soapdog/fafi-browser ) (Racket) - a graphical Gemini browser written in Racket.
2020-09-14 07:17:13 +00:00
- [Lagrange ](https://git.skyjake.fi/skyjake/lagrange ) (C) - a desktop GUI client with inline image viewing, multiple tabs, bookmarks and more.
2020-08-25 20:22:04 +00:00
- [Moonlander ](https://sr.ht/~admicos/moonlander/ ) (Rust) - the fanciest Gemini client in the entire solar system.
- [Kristall ](https://github.com/MasterQ32/kristall ) (C++) - a graphical Gopher and Gemini client using QT.
- [spacewar ](https://github.com/ResonAtom/spacewar ) (Electron.js) - a Gemini browser running on Electron.
2020-08-27 20:08:37 +00:00
#### Mobile
2020-09-29 15:34:46 +00:00
- [Ariane ](https://oppenlab.net/pr/ariane/ ) (Kotlin/Java) - a Gemini protocol client for Android based OS.
2020-08-27 20:08:37 +00:00
- [Deedum ](https://github.com/snoe/deedum ) (Dart) - an Android and iOS client made with Flutter.
2021-01-31 16:54:24 +00:00
- [Elaho ](https://github.com/pitr/gemini-ios ) (Swift) - a full featured Gemini protocol browser for iOS.
2020-11-23 06:14:36 +00:00
- [Xenia ](https://gitlab.com/tslocum/xenia ) (Java) - a Gemini proxy for Android.
2020-08-21 07:54:14 +00:00
2020-08-27 20:08:37 +00:00
#### Windows
- [GemiNaut ](https://www.marmaladefoo.com/pages/geminaut ) (C#) - a user friendly graphical Gemini client for MS Windows.
2020-08-21 07:54:14 +00:00
## Programming
2020-10-13 15:23:18 +00:00
- [gemclient ](https://github.com/Koshroy/gemclient ) (Nim) - a rich client library for the Gemini Protocol.
2020-08-25 20:22:04 +00:00
- [gemini ](https://github.com/derhuerst/gemini ) (Node.js) - a server & client lib.
2020-11-02 08:08:57 +00:00
- [a-h/gemini ](https://github.com/a-h/gemini ) (Go) - Applications and libraries for building applications on Gemini.
2020-10-13 15:14:42 +00:00
- [go-gemini ](https://git.sr.ht/~yotam/go-gemini ) (Go) - a library that provides an easy interface to create client and servers.
2020-10-13 15:18:53 +00:00
- [go-gemini ](https://github.com/makeworld-the-better-one/go-gemini ) (Go) - a more recent fork of the library above.
2020-08-25 20:22:04 +00:00
- [gig ](https://github.com/pitr/gig ) (Go) - a Gemini framework.
2020-12-07 18:40:06 +00:00
- [ruby-net-text ](https://git.umaneti.net/ruby-net-text/ ) (Ruby) - Gemini support in Net::* and URI::* stack.
2021-01-18 07:50:03 +00:00
- [ignition ](https://github.com/cbrews/ignition ) (Python) - a Gemini client transport/request library for python3.
2020-08-21 07:54:14 +00:00
2020-08-22 18:20:56 +00:00
## Resources
2020-08-25 20:22:04 +00:00
- [Gemini Specification ](https://gemini.circumlunar.space/docs/specification.html ) - the Gemini protocol specification.
- [gemini.circumlunar.space/software ](https://portal.mozz.us/gemini/gemini.circumlunar.space/software/ ) - a list of Gemini software.
- [transjovian.org/gemini ](https://portal.mozz.us/gemini/transjovian.org:1965/gemini/ ) - a wiki space dedicated to Gemini communities and software.
2020-08-22 18:20:56 +00:00
2020-08-21 07:54:14 +00:00
## Servers
2020-08-25 20:22:04 +00:00
- [Agate ](https://github.com/mbrubeck/agate ) (Rust) - a simple Gemini server for static files.
2020-11-02 08:08:57 +00:00
- [a-h/gemini ](https://github.com/a-h/gemini ) (Go) - Server for Linux, Mac, Raspberry Pi. Supports SNI for multiple domains on the same server, has Docker image.
2020-08-25 20:22:04 +00:00
- [blizanci ](https://github.com/mk270/blizanci ) (Erlang) - a server designed primarily for robustness and security.
- [Denoscuri ](https://github.com/caranatar/denoscuri ) (Typescript) - a simple Gemini server written using Deno and Typescript.
2020-12-03 08:57:04 +00:00
- [Dʒɛmɪ ni ](https://sr.ht/~rwv/dezhemini/ ) (Racket) - a server with features like SNI and CGI.
2020-11-20 07:40:45 +00:00
- [Diamant ](https://git.umaneti.net/diamant/ ) (Ruby) - a simple Gemini server for static files.
2020-09-01 06:09:31 +00:00
- [Duckling proxy 🦆 ](https://portal.mozz.us/gemini/gemini.marmaladefoo.com/blog/31-Aug-2020_The_Duckling_Proxy.gmi ) (Go) - a scheme-specific filtering proxy for Gemini clients to access the web.
2020-11-30 12:15:55 +00:00
- [Earl Server ](https://github.com/mrletourneau/EarlServer ) (Kotlin) - a Gemini fileserver for the JVM.
2020-08-25 20:22:04 +00:00
- [GeGoBi ](https://tildegit.org/solderpunk/gegobi ) (Python) - a server to facilitate easy Gemini-Gopher bi-hosting.
2020-12-01 16:34:16 +00:00
- [Gemeaux ](https://github.com/brunobord/gemeaux ) (Python) - a Server using only the Python standard library.
2020-08-25 20:22:04 +00:00
- [gemini-server ](https://hackage.haskell.org/package/gemini-server ) (Haskell) - a lightweight server for the Gemini protocol.
- [geminid ](https://github.com/jovoro/geminid/ ) (C) - a Gemini Server in C.
2020-08-26 20:03:44 +00:00
- [geminid ](https://www.upyum.com/cgit.cgi/geminid ) (Scheme) - a Gemini Server in CHICKEN Scheme.
2020-09-29 00:28:18 +00:00
- [gemini-php ](https://opensource.glasgow.social/gemini-php ) (PHP) - a simple Gemini server in PHP.
2021-01-20 19:55:40 +00:00
- [geminim ](https://github.com/ardek66/geminim ) (Nim) - an async lightweight Gemini server made in Nim.
2020-09-29 00:28:18 +00:00
- [gmnisrv ](https://sr.ht/~sircmpwn/gmnisrv/ ) (C) - a high-performance Gemini server for POSIX systems.
2020-08-25 20:22:04 +00:00
- [Gemserv ](https://portal.mozz.us/gemini/80h.dev/projects/gemserv/ ) (Rust) - a server with features like vhosts, CGI, SCGI, reverse-proxying and more.
- [Germinal ](https://github.com/jfmcbrayer/germinal ) (Common Lisp) - serves any type of document with an appropriate mime type.
2020-12-07 18:40:06 +00:00
- [GLV-1.12556 ](https://github.com/spc476/GLV-1.12556 ) (Lua) - the first Gemini protocol server with a lot of features.
2020-09-01 06:09:31 +00:00
- [Jetforce ](https://github.com/michael-lazar/jetforce ) (Python) - a built-in static file server with support for gemini directories and CGI scripts.
2020-11-21 18:37:36 +00:00
- [Lupa Pona ](https://github.com/kensanata/lupa-pona ) (Perl) - a simple single directory Gemini server.
2020-08-25 20:22:04 +00:00
- [Marami ](https://github.com/MagnificentPako/Marami/ ) (Prolog) - a server written in Prolog.
- [Molly Brown ](https://tildegit.org/solderpunk/molly-brown ) (Go) - a full-featured Gemini server implemented in Go.
2020-10-13 15:01:59 +00:00
- [net-gemini ](https://github.com/jackdoe/net-gemini ) (Go) - a gemini server inspired by Molly Brown.
2020-12-08 06:45:15 +00:00
- [northstar ](https://github.com/panicbit/northstar ) (Rust) - a gemini server implementation.
2020-09-29 00:28:18 +00:00
- [Orbit ](https://tildegit.org/sumpygump/orbit ) (PHP) - a Gemini server implemented in PHP.
2020-09-01 06:09:31 +00:00
- [pollux ](https://git.sr.ht/~julienxx/pollux ) (Rust) - a simple server that will only serve one `index.gemini` file.
2020-10-05 06:44:40 +00:00
- [Satellite ](https://sr.ht/~gsthnz/satellite/ ) (Go) - a small Gemini server for serving static files.
2020-08-25 20:22:04 +00:00
- [Shavit ](https://git.sr.ht/~yotam/shavit ) (Go) - a configurable Gemini server for UNIX operating systems.
2020-09-01 06:09:31 +00:00
- [Space-Age ](https://gitlab.com/lambdatronic/space-age ) (Clojure) - a Gemini server written in Clojure.
2020-08-25 15:52:56 +00:00
- [Titan ](https://github.com/jahzielv/titan ) (Rust) - a simple TOML-configured Gemini server and an Express-like Gemini server framework.
2020-11-20 18:27:55 +00:00
- [twins ](https://gitlab.com/tslocum/twins ) (Go) - a YAML-configured Gemini server supporting vhosts, FastCGI and reverse-proxying.
2020-08-21 07:54:14 +00:00
2020-11-27 08:43:06 +00:00
## Services
2020-11-30 21:47:11 +00:00
- __gemini://drewdevault.com:1965/cgi-bin/man.sh__ - look up a POSIX man page.
2020-11-30 12:21:02 +00:00
- __gemini://flounder.online__ ([https version](https://flounder.online/)) - host small Gemini web pages over https and Gemini ([repo](https://sr.ht/~alexwennerberg/flounder/)).
2020-11-30 17:25:22 +00:00
- __gemini://glv.one__ - a free platform as a service (PaaS) that runs any Gemini server (packaged as a Docker image) in the cloud.
2020-11-27 08:43:06 +00:00
- __gemini://gus.guru/__ - Gemini Universal Search ([repo](https://natpen.net/code/gus)).
2020-12-01 15:08:57 +00:00
- __gemini://tictactoe.lanterne.chilliet.eu__ - a Tic Tac Toe game ([repo](https://framagit.org/MCMic/gemini-tictactoe)).
2020-11-27 08:43:06 +00:00
- __gemini://ur.gs/__ - translate from en->es and es->en ([repo](https://code.ur.gs/lupine/capsule/src/branch/main/src/cgi-bin/translate)).
2020-12-02 18:47:29 +00:00
- __gemini://rawtext.club:1965/~sloum/geminews/__ - Daily news feeds proxied to gemini.
- __gemini://rawtext.club:1965/~sloum/cgi/othello/__ - Play othello/reversi against a computer opponent over gemini.
- __gemini://rawtext.club:1965/~sloum/cgi/weather__ - US weather reports by zip code.
- [gemlog.blue ](https://gemlog.blue ) - Gemini hosting from a web frontend.
2020-11-27 08:43:06 +00:00
2020-12-01 15:08:57 +00:00
2020-08-21 07:54:14 +00:00
## Tools
2020-08-27 15:24:31 +00:00
- [gemini-pandoc-lua-filter ](https://github.com/kr1sp1n/gemini-pandoc-lua-filter ) (Lua) - a lua filter for pandoc to output Gemini text.
2020-08-22 17:58:53 +00:00
- [gemini-to-html ](https://github.com/RangerMauve/gemini-to-html ) (Node.js) - a JavaScript library for parsing Gemini pages, and for rendering them to HTML.
2021-01-18 07:50:03 +00:00
- [geminize ](https://addons.mozilla.org/en-US/firefox/addon/geminize/ ) - a Firefox addon that redirects gemini:// URLs and links to a customizable HTTP-to-Gemini proxy.
2020-12-08 06:45:15 +00:00
- [gem.git ](https://git.sr.ht/~fkfd/git.gmi/ ) (Python) - git frontend CGI script.
2020-08-27 15:24:31 +00:00
- [gloggery ](https://github.com/kconner/gloggery ) (Go) - basic static site generator for blogs in Gemini.
2020-11-23 06:14:36 +00:00
- [gmitohtml ](https://gitlab.com/tslocum/gmitohtml ) (Go) - a proxy that renders Gemini pages using HTML.
2020-11-30 12:15:55 +00:00
- [gmnhg ](https://git.tdem.in/tdemin/gmnhg ) (Go) - renders a Hugo site to a Gemini site.
2021-01-11 19:13:05 +00:00
- [kiln ](https://git.sr.ht/~adnano/kiln ) (Go) - a simple static site generator for Gemini sites.
2020-11-30 12:15:55 +00:00
- [md2gmn ](https://git.tdem.in/tdemin/gmnhg ) (Go) - renders Markdown text to Gemini pages.
2020-12-07 18:40:06 +00:00
- [spacewalk ](https://tildegit.org/sloum/spacewalk ) (Go) - Page-hash based feed aggregator for gemini.
- [CAPCOM ](https://tildegit.org/solderpunk/CAPCOM ) (Python) - Atom feed aggregator for gemini.
2020-12-02 18:42:15 +00:00
### Syntax Highlighting
2020-12-07 18:40:06 +00:00
- [gemini-vim-syntax ](https://tildegit.org/sloum/gemini-vim-syntax ) - text/gemini syntax highlighting for vim.
- [gemini.el ](https://git.carcosa.net/jmcbray/gemini.el ) - text/gemini syntax highlighting for emacs.
- [gemini.kak ](https://github.com/kakoune-editor/kakoune-extra-filetypes/blob/master/rc/gemini.kak ) - text/gemini syntax highlighting for kakoune.
- [gemini.nanorc ](https://github.com/yzzyx-network/nanorc/blob/master/gemini.nanorc ) - text/gemini syntax highlighting for nano.
2020-08-21 07:54:14 +00:00
## Web proxies
- [Mozz.us portal ](https://portal.mozz.us/gemini/gemini.circumlunar.space/ )
2020-09-07 05:55:19 +00:00
- [Soweli Lukin ](https://alexschroeder.ch/soweli-lukin )
2020-08-21 07:54:14 +00:00
- [Vulpes proxy ](https://proxy.vulpes.one/gemini/gemini.circumlunar.space/ )
---
[1]: https://gemini.circumlunar.space/