Skip to content

Astronomo

A Gemini browser for the terminal.

Astronomo is a modern terminal-based browser for the Gemini protocol, built with Python using Textual for the TUI and Nauyaca for Gemini protocol support.

Features

  • Keyboard-First Navigation

    Navigate links with arrow keys, browse history with backspace, and access all features without leaving the keyboard.

  • Bookmarks with Folders

    Organize your favorite capsules with a hierarchical bookmark system, stored locally in TOML format.

  • Themeable Interface

    Choose from built-in Textual themes or customize the appearance to your liking.

  • Session History

    Navigate back and forward through your browsing session with scroll position preservation.

  • Certificate Management

    Create and manage client certificates for authenticated Gemini sites.

  • Syntax Highlighting

    Code blocks in preformatted text are automatically syntax-highlighted.

  • GMAP Mail

    Send and receive mail via the Misfin protocol with a three-pane mail interface.

  • RSS/Atom Feeds

    Subscribe to and read feeds from Geminispace with folder organization.

  • Multi-Protocol

    Browse Gemini, Gopher, Finger, Nex, and Spartan resources natively.

Quick Example

# Install with uv (recommended)
uv tool install astronomo

# Or with pip
pip install astronomo

# Launch and browse
astronomo gemini://geminiprotocol.net/

Getting Started

Project Status

Astronomo is under active development:

Feature Status
Interactive link navigation ✅
Styled Gemtext rendering ✅
History (back/forward) ✅
Bookmarks with folders ✅
Configuration file ✅
Input prompts (search, passwords) ✅
Client certificates ✅
Multiple tabs ✅
Multi-protocol (Gemini, Gopher, Finger, Nex, Spartan) ✅
RSS/Atom feeds ✅
GMAP mail (Misfin) ✅
Inline images (Chafa) ✅
Quick navigation (fuzzy finder) ✅

See the Changelog for version history.