qute-gemini

A qutebrowser userscript that allows viewing Gemini pages by pressing a custom key. 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

The XDG Base Directory Specification is supported but the default directory paths are used for simplicity.

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

2. Set custom keybindings for opening Gemini URLs by adding the following lines to ~/.config/qutebrowser/config.py:

   # Open in the current tab
   config.bind(';g', 'hint links userscript qute-gemini')
   # Open in a new tab
   config.bind(';G', 'hint links userscript qute-gemini-tab')
   

   The script only processes gemini:// URLs and opens all other URLs using qutebrowser, so opening a non-gemini:// should also work.

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

Custom CSS

You can create a CSS file ~/.local/share/qutebrowser/userscripts/qute-gemini.css and qute-gemini will use it to style Gemini pages shown in qutebrowser. The kineto or Gemini homepage CSS styles both work well.

Known issues

• Userscript limitations
  • Only text/gemini content is shown. Any other MIME types received over Gemini are considered an error.
  • There is no support for user input (Gemini codes 1*).
  • There is no support for client certificates (Gemini codes 6*).
  • Opening non-gemini:// URLs with the userscript might not work correctly in rare cases.
• Qutebrowser limitations
  • Opening gemini:// URLs from the URL bar does not work. It is only possible to open URL in the current page via the hints.
  • 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.