# Awesome Gemini [![Awesome](https://awesome.re/badge-flat.svg)](https://awesome.re) 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. ## 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. Connections are closed at the end of a single transaction and cannot be reused. When Gemini is served over TCP/IP, servers 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. ## Contents - [Clients](#clients) - [Terminal](#terminal) - [Graphical](#graphical) - [Cross-platform](#cross-platform) - [Mobile](#mobile) - [Windows](#windows) - [Programming](#programming) - [Resources](#resources) - [Servers](#servers) - [Tools](#tools) - [Web proxies](#web-proxies) ## Clients ### Terminal - [Amfora](https://github.com/makeworld-the-better-one/amfora) (Go) - a "fancy" terminal client. - [Asuka](https://tildegit.org/julienxx/asuka) (Rust) - an NCurses-based Gemini client. - [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. - [Bombadillo](https://rawtext.club/~sloum/bombadillo.html) (Go) - a combined Gopher and Gemini client with vim-inspired key mappings. - [diohsc](https://mbays.sdf.org/diohsc/) (Haskell) - a simple line-based command-response terminal user interface with ANSI colour. - [Elpher](https://thelambdalab.xyz/elpher/) (Emacs) - a combined Gopher and Gemini client for the popular text editor / operating system. - [gemini-demo-1](https://tildegit.org/solderpunk/gemini-demo-1) (Python) - a minimal but usable interactive Gemini client in < 100 LOC of Python 3. - [gemini-demo-2](https://tildegit.org/solderpunk/gemini-demo-2) (Lua) - a minimal but usable interactive Gemini client in < 100 LOC of Lua. - [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. - [gemini-fetch](https://github.com/RangerMauve/gemini-fetch) (Node.js) - a cURL-like CLI for loading content from Gemini URLs. - [gmni](https://sr.ht/~sircmpwn/gmni/) (C) - a CLI utility (like curl) and a line-mode browser. - [min](https://github.com/a-h/min) (Go) - supports advanced features like input and client certificate generation. ### Graphical #### Cross-platform - [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. - [Lagrange](https://git.skyjake.fi/skyjake/lagrange) (C) - a desktop GUI client with inline image viewing, multiple tabs, bookmarks and more. - [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. #### Mobile - [Ariane](https://oppenlab.net/pr/ariane/) (Kotlin/Java) - a Gemini protocol client for Android based OS. - [Deedum](https://github.com/snoe/deedum) (Dart) - an Android and iOS client made with Flutter. - [Gemini Browser](https://github.com/pitr/gemini-ios) (Swift) - iOS native browser. #### Windows - [GemiNaut](https://www.marmaladefoo.com/pages/geminaut) (C#) - a user friendly graphical Gemini client for MS Windows. ## Programming - [gemini](https://github.com/derhuerst/gemini) (Node.js) - a server & client lib. - [gemini](https://github.com/a-h/gemini) (Go) - Applications and libraries for building applications on Gemini. - [gig](https://github.com/pitr/gig) (Go) - a Gemini framework. ## Resources - [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. ## Servers - [Agate](https://github.com/mbrubeck/agate) (Rust) - a simple Gemini server for static files. - [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. - [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. - [GeGoBi](https://tildegit.org/solderpunk/gegobi) (Python) - a server to facilitate easy Gemini-Gopher bi-hosting. - [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. - [geminid](https://www.upyum.com/cgit.cgi/geminid) (Scheme) - a Gemini Server in CHICKEN Scheme. - [gemini-php](https://opensource.glasgow.social/gemini-php) (PHP) - a simple Gemini server in PHP. - [gmnisrv](https://sr.ht/~sircmpwn/gmnisrv/) (C) - a high-performance Gemini server for POSIX systems. - [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. - [GLV-1.12556](https://github.com/spc476/GLV-1.12556) (Lua) - the first Gemini protocol server with a lot of features - [Jetforce](https://github.com/michael-lazar/jetforce) (Python) - a built-in static file server with support for gemini directories and CGI scripts. - [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. - [net-gemini](https://github.com/jackdoe/net-gemini) (Go) - a gemini server inspired by Molly Brown. - [Orbit](https://tildegit.org/sumpygump/orbit) (PHP) - a Gemini server implemented in PHP. - [pollux](https://git.sr.ht/~julienxx/pollux) (Rust) - a simple server that will only serve one `index.gemini` file. - [Satellite](https://sr.ht/~gsthnz/satellite/) (Go) - a small Gemini server for serving static files. - [Shavit](https://git.sr.ht/~yotam/shavit) (Go) - a configurable Gemini server for UNIX operating systems. - [Space-Age](https://gitlab.com/lambdatronic/space-age) (Clojure) - a Gemini server written in Clojure. - [Titan](https://github.com/jahzielv/titan) (Rust) - a simple TOML-configured Gemini server and an Express-like Gemini server framework. ## Tools - [gemini-pandoc-lua-filter](https://github.com/kr1sp1n/gemini-pandoc-lua-filter) (Lua) - a lua filter for pandoc to output Gemini text. - [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. - [gloggery](https://github.com/kconner/gloggery) (Go) - basic static site generator for blogs in Gemini. ## Web proxies - [Mozz.us portal](https://portal.mozz.us/gemini/gemini.circumlunar.space/) - [Soweli Lukin](https://alexschroeder.ch/soweli-lukin) - [Vulpes proxy](https://proxy.vulpes.one/gemini/gemini.circumlunar.space/) --- [1]: https://gemini.circumlunar.space/