gemini.koplugin: Gemini client for KOReader

A Gemini client aimed at internet-enabled touch-screen e-book reader devices, implemented as a plugin for KOReader.

KOReader website

Installing / updating

• Update KOReader if necessary -- versions 2023.03 and later should be supported.
• Download the tarball or git repository below, and extract to the plugins/ directory within your koreader directory (e.g. /.adds/koreader/plugins/), such that the directory plugins/gemini.koplugin/ exists.
• Restart KOReader, and select "Browse Gemini" from the search menu to get started.

tarball

git repository (cloneable url)

git bundle

Features

• File viewing via KOReader, supporting many filetypes.
• Bookmarks, history, and queue, with caching for offline use.
• Trust-On-First-Use verification of server identities.
• Use and generation of user identities (client certificates).
• Configurable navigation gestures.
• File upload via Titan.

Screenshot

Limitations

• Resuming TLS sessions not supported; full handshake performed on each connection.
• Displaying files during download ("streaming") not supported.
• CA-based certificate verification not supported; user prompted each time the tail certificate changes.

Further TODOs

Compatibility

Tested on Kobo Glo HD with KOReader versions >= 2023.03. May be difficult to use on non-touch devices; feedback on this welcome. Tested as not working on Android, for reasons unknown.

Licence

You may distribute this plugin under the terms of the GPL, version 3 or later.

GPLv3

Feedback

Please write to <mbays@sdf.org> with any bug reports, feature requests, patches, etc.