qute-gemini/README.md

# qute-gemini

A [qutebrowser](https://qutebrowser.org) userscript that allows viewing
[Gemini](https://gemini.circumlunar.space) pages. The pages are converted to
HTML by the script and then displayed in qutebrowser.

The script borrows code from [gcat](https://github.com/aaronjanse/gcat), many
thanks to its authors!



## Installation

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

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

    ``` python
    # 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 or restart qutebrowser and visit the
   [Gemini spec homepage](gemini://gemini.circumlunar.space)
   to ensure that everything works.



## Known issues

- Userscript limitations
    - Only `text/gemini` content is shown.
- 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](https://www.gnu.org/licenses/gpl.html) 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.