Skip to main content

Rogallo

Rogallo

GitHub Actions Workflow Status GitHub commits since latest release GitHub Issues or Pull Requests GitHub Release Date PyPI - License PyPI - Python Version PyPI - Version

Introduction

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

  • Support for the gemini, titan, spartan, gopher, nex 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

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.

pipx

The application can be installed using pipx:

pipx install rogallo

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.

Metadata

Release files for rogallo 3.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rogallo 3.2.0
File Size Uploaded
rogallo-3.2.0.tar.gz 90.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for rogallo 3.2.0
File Interpreter ABI Platform
rogallo-3.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 231.6 kB

Release files / rogallo-3.2.0.tar.gz

Download URL rogallo-3.2.0.tar.gz
Size 90.6 kB
Tags Source
SHA-256 checksum
How to use checksums
4885f7be1c241e52b560811ba0c97c44aa2e41b16cf2edebf8d6f70192b6ed10
BLAKE2b-256 checksum
How to use checksums
8cdf29295a22151f913ad3c64fb9c637f7dea0d0981f57308dcd7cee3900bc3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}

Release files / rogallo-3.2.0-py3-none-any.whl

Download URL rogallo-3.2.0-py3-none-any.whl
Size 141.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f0a0d82e4758e8b001d93fac4216a0420e617e32fbbeee97e7f6e38146b06b09
BLAKE2b-256 checksum
How to use checksums
a9f91647bd83bc65ebfa0d6674fa7bb3273b14524eca7bbfaade61a8b03a48c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}

Release history Release notifications | RSS feed

This release

3.2.0 This release

2 release files

3.1.0

2 release files

3.0.0

2 release files

2.4.0

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.12.1

2 release files

1.12.0

2 release files

1.11.0

2 release files

1.10.0

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.2

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.12.0

2 release files

0.11.0

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page