Rogallo

Introduction

Rogallo is a terminal-based client for browsing Geminispace, Spartanspace, Gopherspace, and Fingerspace. Its key features include:

• Support for the gemini, spartan, gopher, and finger protocols
• Bookmarks management with search
• Location history tracking with search
• Backward and forward page navigation
• Copy-to-clipboard support for URIs or page content
• Configurable home page
• Full mouse navigation and interaction support
• Built-in source viewer
• Context-sensitive help screens
• Command palette for quick command discovery and execution
• Automatic handoff of unknown MIME types to the operating system
• Optional rendering (on by default) of ANSI escape sequences in pages
• Local Gemtext file viewing
• Built-in theme selection, plus support for user-supplied custom UI themes
• Persistent configuration across sessions
• Fully responsive layout that adjusts dynamically to terminal resizing
• Cross-platform support for macOS, GNU/Linux, Windows, and other operating systems running modern Python

Key features for Gemini protocol support include:

• User input handling (1x responses), including masked inputs for sensitive fields
  • Optional external text editor integration for composing inputs
• In-application generation of self-signed client certificates, with persistent per-capsule management
• Redirection handling (3x responses)
• Flexible capsule certificate verification for both CA-signed and self-signed certificates

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:

• ~/.cache/rogallo/* -- The document cache.
• ~/.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.