Minimal but usable interactive Gemini client in almost < 100 LOC of Go
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Solderpunk 1d6bcf551c
Handle preformatted content.
3 years ago
.gitignore Initial commit 3 years ago
LICENSE Initial implementation. 3 years ago Initial implementation. 3 years ago
gemini-demo.go Handle preformatted content. 3 years ago


Minimal but usable interactive Gemini client in not quite < 100 LOC of Go.


One of the original design criteria for the Gemini protocol was that "a basic but usable (not ultra-spartan) client should fit comfortably within 50 or so lines of code in a modern high-level language. Certainly not more than 100". This client was written to gauge how close to (or far from!) that goal the initial rough specification is.


This crude but functional client:

  • Has a minimal interactive interface for "Gemini maps"
  • Will print plain text in UTF-8
  • Will NOT prompt for user input
  • Will NOT follow redirects
  • Will report errors
  • Does NOT DO ANY validation of TLS certificates

Non-text files are not yet handled.

This is less functional than the Python demo (gemini-demo-1) or Lua demo (gemini-demo-2). Further, it's the only one of these demo clients which is not currently below 100 lines. This may be as much due to my inexperience with Go as with the language's unavoidable verbosity. Improvements welcome.


Run the client and you'll get a prompt. Type a Gemini URL (the scheme is implied, so simply entering e.g. will work) to visit a Gemini location.

If a Gemini menu is visited, you'll see numeric indices for links, ala VF-1 or AV-98. Type a number to visit that link.

There is very crude history: you can type b to go "back".

Type q to quit.