Python Gemini CLI client. Upgraded, thicc version of solderpunk/Gemini-demo-1.
Go to file
wholesomedonut 720abf23f0 Update 'README.md' 2023-02-09 05:33:08 +00:00
.gitignore Initial commit 2019-06-24 10:41:14 -04:00
LICENSE Forked from solderpunk's repo 2020-09-06 19:35:18 -06:00
README.md Update 'README.md' 2023-02-09 05:33:08 +00:00
asparagus.py fixed readme after 2 years 2023-02-09 05:27:07 +00:00

README.md

asparagus

Larger, more functional version of solderpunk's gemini-demo-1, which was a Gemini client in <=100 LOC in Python 3.

Why the fork?

I really enjoyed solderpunk's work. Quick, clean, and tiny.

I just wanted to try my luck at getting a more fleshed-out app going.

This will probably wind up getting ported to Clojure.

Capabilities

This fork has all of gemini-demo-1's functionality:

  • Has a minimal interactive interface for "Gemini maps"
  • Will print plain text in any encoding if it is properly declared in the server's response header
  • Will handle binary files using programs specified in /etc/mailcap (so you can, e.g. view images)
  • Will follow redirects
  • Will report errors
  • Does NOT DO ANY validation of TLS certificates

IN addition to:

  • Has session-persistent history that you can repeatedly maneuver through
  • Descriptive error texts
  • More keyboard commands and CLI-accessible help text.

Usage

Run the script and you'll get a prompt. Type a Gemini URL (the scheme is implied, so simply entering e.g. gemini.conman.org 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.

Press h to see a printout of your history, b to go back a page, and f to go forward a page.

Type ? to see a brief help text inside the client.

Press q to quit.