qute-gemini

A qutebrowser userscript that allows viewing Gemini pages. The pages are converted to HTML by the script and then displayed in qutebrowser.

The script borrows code from gcat, many thanks to its authors!

Installation

1. Copy qute-gemini and qute-gemini-tab into ~/.local/share/qutebrowser/userscripts/.

2. Add the following lines to ~/.config/qutebrowser/config.py

   config.bind('f', 'hint links userscript qute-gemini')
   config.bind('F', 'hint links userscript qute-gemini-tab')
   

   The script only processes gemini:// URLs and opens all other URLs using qutebrowser, so it should be safe to replace the default hint keybindings.

3. Re-source the qutebrowser config and visit the Gemini spec homepage to ensure that everything works.

Known issues

• Userscript limitations
  • Only text/gemini content is shown.
  • Probably tons of usability issues.
• Qutebrowser limitations
  • Opening gemini:// URLs by clicking on them does not work, only opening them via the keybinding is possible.
  • Qutebrowser userscripts don't accept arguments. My solution to being able to open links in the same or a different tab was to call the script under a different name.

License

Copyright 2019 Solderpunk, 2020 Aaron Janse, 2020 petedussin, 2020-2021 Sotiris Papatheodorou

This program is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

gcat is distributed under the BSD 2-Clause license.