💾 Archived View for gemini.thegonz.net › gemini.koplugin captured on 2024-08-18 at 17:23:39. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

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.