What is Gemini?
Gemini is both a document markup format and an internet protocol for accessing and downloading documents and other files.
The official project website is gemini.circumlunar.space.
The Gemini format is a plain-text format. The formatting is line-based and the documents are encoded using UTF-8.
Since the document format is simple and lacks recursive features, it can be parsed with a basic state-machine parser.
The Gemini protocol is a simple network protocol that can be used to fetch files from servers. The protocol follows a request-response model, and handles one response per connection. This is similar to HTTP with the
Connection: close header.
The protocol uses a TLS connection over TCP. Here’s how a simple exchange looks.
- Client establishes connection to the server.
- Client sends the requested URL, followed by a newline.
- The server responds with a status code and a MIME type, followed by a newline.
- Any content received until the connection closes is the response body.
The project was well-received in Hacker circles; such as Hacker News, the Tildeverse and the Fediverse. A lot of people who are involved with the Gopher protocol have shown interest in the Gemini protocol as well.
Aside from blogs and personal notes, the Gemini community provides a lot of services over the protocol. Some of those services include search engines, news aggregators, weather reports and discussion forums.
Similar to Gopher, Gemini also has multiple proxies that allow the content to be viewed from web browsers. Here are some example links.
Simplicity, or lack thereof
Most aspects of the protocol and the document format are very simple and easy to implement. Despite this, the protocol specification mandates the use of TLS, making stand-alone implementations very difficult. If one is okay with using an external library or wrapper to implement TLS, the rest of the protocol should be quite simple.
As Gemini has been designed with implementation simplicity in mind, there is a large number of Client and Server implementations available.
gmni is a command-line utility to fetch documents over the Gemini protocol. It is developed by Drew DeVault. The source code can be found here.
// TODO: Fill section
- Gemini specification
- This document specifies both the network protocol and the document format