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 website
   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 * Restart KOReader, and select "Browse Gemini" from the search menu to get started.
   9
  10 => gemini.koplugin.tgz tarball
  11 => https://repo.or.cz/gemini.koplugin git repository (cloneable url)
  12 => gemini.koplugin.bundle git bundle
  13
  14 # Features
  15 * File viewing via KOReader, supporting many filetypes.
  16 * Bookmarks, history, and queue, with caching for offline use.
  17 * Trust-On-First-Use verification of server identities.
  18 * Use and generation of user identities (client certificates).
  19 * Configurable navigation gestures.
  20 * File upload via Titan.
  21
  22 => screenshot.png Screenshot
  23
  24 # Limitations
  25 * Resuming TLS sessions not supported; full handshake performed on each connection.
  26 * Displaying files during download ("streaming") not supported.
  27 * CA-based certificate verification not supported; user prompted each time the tail certificate changes.
  28
  29 => TODO.gmi Further TODOs
  30
  31 # Compatibility
  32 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.
  33
  34 # Licence
  35 You may distribute this plugin under the terms of the GPL, version 3 or later.
  36 => COPYING GPLv3
  37
  38 # Feedback
  39 Please write to <mbays@sdf.org> with any bug reports, feature requests, patches, etc.