index.gmi

   1 # gemini.koplugin: Gemini client for KOReader
   2 A Gemini client aimed at internet-enabled touch-screen e-book reader devices, implemented as a plugin for KOReader.
   3 => https://koreader.rocks/ KOReader site
   4
   5 # Installing / updating
   6 * Update KOReader if necessary -- versions 2023.03 and later should be supported.
   7 * 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.
   8 => gemini.koplugin.tgz tarball
   9 => git://thegonz.net/gemini.koplugin/ git clone git://thegonz.net/gemini.koplugin/
  10 => gemini.koplugin.bundle git bundle
  11 * Restart KOReader, and select "Browse Gemini" from the search menu to get started.
  12
  13 # Features
  14 * File viewing via KOReader, so many filetypes supported.
  15 * Bookmarks, history, and queue, with caching for offline use.
  16 * Trust-On-First-Use verification of server identities.
  17 * Use and generation of user identities (client certificates).
  18 * Configurable navigation gestures.
  19
  20 => screenshot.png Screenshot
  21
  22 # Limitations
  23 * Resuming TLS sessions not supported; full handshake performed on each connection.
  24 * Displaying files during download ("streaming") not supported.
  25 * CA-based certificate verification not supported; user prompted each time the tail certificate changes.
  26
  27 => TODO.gmi Further TODOs
  28
  29 # Compatibility
  30 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.
  31
  32 # Licence
  33 You may distribute this plugin under the terms of the GPL, version 3 or later.
  34 => COPYING GPLv3
  35
  36 # Feedback
  37 Please write to <mbays@sdf.org> with any bug reports, feature requests, patches, etc.