A terminal-based client for the Gemini Protocol
Project description
Rogallo
Introduction
Rogallo is a terminal-based client for the Gemini Protocol. Key features include:
- A bookmark facility (with search)
- A location history facility (with search)
- A backward/forward navigation facility
- Support for setting a home page
- Support for user input (
1xresponses), including masked inputs for sensitive fields - Support for in-application generation of self-signed client certificates, with persistent per-capsule management
- Support for redirections (
3xresponses) - Copy-to-clipboard support for URIs or page contents
- Designed to work on macOS, GNU/Linux and Windows (and likely on other operating systems that support modern Python)
- Mouse support
- A view source facility
- A trust-on-first-use (TOFU) trust facility
- Has in-application help screens
- Has an easy-to-use command palette
- Hands unknown MIME types off to the operating system
- Optional support (on by default) for ANSI escape sequences in pages
- Support for viewing local Gemtext files
- Choice of themes
- Persistent user configuration across sessions
- Fully responsive layout that adjusts dynamically to terminal resizing
Installing
pipx
The application can be installed using pipx:
pipx install rogallo
uv
The application can be installed using uv:
uv tool install rogallo
If you don't have uv installed you can use uvx.sh to
perform the installation. For GNU/Linux or macOS or similar:
curl -LsSf uvx.sh/rogallo/install.sh | sh
or on Windows:
powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/rogallo/install.ps1 | iex"
Once installed run the rogallo command.
File locations
Rogallo stores files in an rogallo directory within both $XDG_DATA_HOME
and
$XDG_CONFIG_HOME.
If you wish to fully remove anything to do with Rogallo you will need to
remove those directories too.
Expanding for the common locations, the files normally created are:
~/.config/rogallo/configuration.json-- The configuration file.~/.local/share/rogallo/*-- The locally-held data.
Getting help
If you need help, or have any ideas, please feel free to raise an issue or start a discussion.
TODO
See the TODO tag in issues to see what I'm planning.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rogallo-1.2.0.tar.gz.
File metadata
- Download URL: rogallo-1.2.0.tar.gz
- Upload date:
- Size: 45.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
366f420e9c7c4cfcb1e02ad2ab59a8c18f3bb0e2c25e2756538bf0651776b603
|
|
| MD5 |
9c56f4b3e7f01c26c9c0a718ee9d2c02
|
|
| BLAKE2b-256 |
71534fe952d34b42dee6277629b079b888b25461f357ee20659db435f4329eda
|
File details
Details for the file rogallo-1.2.0-py3-none-any.whl.
File metadata
- Download URL: rogallo-1.2.0-py3-none-any.whl
- Upload date:
- Size: 71.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
41cacd61a32331430add3cfe293bbb6a9606597bd898ad11955de70f270fb38d
|
|
| MD5 |
9ae7ed76eba8f4a72f171f3647aeb431
|
|
| BLAKE2b-256 |
544d2b3a3f031bbf6cd902a11108c62c871c6243d6f3fb88cb0ab947e81eb7a5
|
