Skip to content

Changelog

All notable changes to Astronomo will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Fixed

  • Identity URL prefix matching is now port-aware: a prefix like gemini://example.com/ now correctly matches URLs with explicit ports like gemini://example.com:1958/. Prefixes with explicit ports still only match that specific port
  • "Remember choice" identity prompt mode now auto-selects the best matching identity instead of silently proceeding without one when no session choice exists
  • GMAP mail: Tags in the sidebar are now clickable — clicking a tag selects it and loads its messages
  • GMAP mail: Compose now checks the Misfin send response status; failed deliveries show an error instead of silently proceeding
  • GMAP mail: Sent copy is now tagged as Sent and marked as read instead of appearing in Inbox as unread
  • GMAP mail: Trashing a message now removes the Inbox tag so it disappears from the Inbox view immediately
  • GMAP mail: Messages with Trash tag are excluded from all non-Trash tag views (per GMAP spec)
  • GMAP mail: Single click or keyboard focus on a message now shows it in the reading pane (no longer requires double-click)
  • GMAP mail: Message preview no longer crashes with pydantic TypeError on newer Python versions; parsing now happens eagerly with proper error handling
  • GMAP mail: Compose now validates recipient address format more strictly — both mailbox and hostname parts must be non-empty and hostname must contain a dot (e.g., user@host.tld)
  • GMAP mail: Compose now notifies the user with a warning if the Sent copy fails to save, instead of silently logging the error
  • Fixed Select.BLANK deprecation — replaced with Select.NULL across all modals for Textual 8.0 compatibility (bookmark, feed, and mail account modals)

Improved

  • GMAP mail: Tag checkboxes in "Manage Tags" modal now use a 2-column grid layout instead of one-per-line

Changed

  • GMAP mail: Renamed "Preview" panel to "Message" since it is the full reading interface
  • GMAP mail: Up/Down arrows navigate within the current panel without switching panels; Left/Right arrows and Tab/Shift+Tab switch between panels
  • GMAP mail: Non-email app bindings (bookmarks, snapshots, tabs, etc.) are suppressed while the mail screen is open
  • GMAP mail: Message list cards now show a truncated body preview beneath the subject line

Added

  • GMAP mail: Account switcher (Ctrl+L or click "Switch Account" button) to switch between configured GMAP accounts and remove accounts without leaving the mail screen
  • Misfin protocol URL support: misfin: links in Gemtext pages and the address bar now open the mail compose screen with recipients pre-filled. Percent-encoded query text is parsed for subject (# heading) and body, following the mailto:-style URI format (RFC 3986 compliant, no //)
  • GMAP mail client: Full terminal mail experience for Misfin mailboxes via GMAP protocol (Ctrl+E)
  • Three-pane mail interface: tags sidebar, message list, and message preview
  • Account management with TOML persistence and certificate-based authentication
  • SQLite message cache for fast queries and offline access at ~/.cache/astronomo/
  • Incremental sync with timestamp-based filtering for efficient updates
  • Tag operations: archive (a), trash (d), toggle unread (u), manage custom tags (t)
  • Two-step delete workflow: move to Trash first, then permanently delete (D)
  • Compose and reply with gemtext body, sent via Misfin protocol
  • Sent mail copies stored on GMAP server for Sent folder tracking
  • Background sync using @work for non-blocking UI
  • Mail settings tab in Settings (Ctrl+,) for account management
  • Browser tabs: Multiple tabs with independent browsing sessions
  • Tab bar at the top with clickable tabs showing page titles
  • Keyboard shortcuts: Ctrl+T (new tab), Ctrl+W (close tab), Ctrl+Tab/Ctrl+Shift+Tab (switch tabs), Ctrl+1-9 (jump to tab)
  • Each tab maintains its own history, scroll position, and link selection
  • Open links in new tabs via Ctrl+click, middle-click, or Ctrl+Enter
  • Tab state preserved when switching between tabs
  • Search and pagination for Known Hosts settings: Filter hosts by hostname and navigate through pages of 10 items for faster loading
  • TOFU (Trust On First Use) certificate change handling: When a server's certificate changes, users now see a warning modal with options to Accept, Reject, or View Details before proceeding
  • Certificate details modal: Compare old vs new certificate fingerprints with full SHA-256 hashes and trust timestamps
  • Known Hosts management: New "Known Hosts" tab in Settings (Ctrl+,) to view and revoke trusted server certificates
  • Starry night ASCII art in the welcome message displayed when launching without a URL
  • Multi-protocol support: Astronomo now supports browsing Gopher (via mototli) and Finger (via mapilli) protocols in addition to Gemini
  • Smart URL detection: URLs in the address bar are automatically prefixed with the appropriate scheme (user@host → finger://, gopher.* → gopher://, otherwise gemini://)
  • Gopher protocol features:
  • Directory listings with type indicators ([DIR], [TXT], [SEARCH], [BIN], [IMG])
  • Text file viewing with preformatted display
  • Search support (type 7) via reused InputModal
  • Binary file downloads saved to ~/Downloads
  • Finger protocol: User information displayed as preformatted text
  • Nex protocol support: Browse Nex resources (nex:// URLs) using simple TCP on port 1900
  • Directory listings displayed natively (Nex uses Gemtext-compatible format)
  • Auto-detection for nex.* hostnames and :1900 port
  • Inline TCP client implementation (no external library dependency)
  • Binary file downloads with automatic detection (null bytes, non-UTF8 content)
  • Spartan protocol support: Browse Spartan resources (spartan:// URLs) using TCP on port 300 (via teyaotlani)
  • Single-digit status code handling (2=success, 3=redirect, 4=client error, 5=server error)
  • Auto-detection for spartan.* hostnames and :300 port
  • Automatic redirect following (respects max_redirects config)
  • MIME-based binary file detection and downloads to ~/Downloads
  • Input links support (=: syntax): Interactive forms that prompt for user input before sending data to the server
    • 10KB data limit enforced (Spartan protocol specification)
    • Displays both link label and target URL in input modal
    • Multi-line input support with automatic expansion
    • Real-time byte counter with visual warnings
    • Data sent via Spartan upload mechanism (not appended to URL like Gemini)
  • Cross-protocol link navigation: Click links to navigate between Gemini, Gopher, Finger, Nex, and Spartan resources
  • HTTP/HTTPS links now open in the system browser instead of showing an error
  • "Open File" button on download complete page: After downloading binary files, click to open with system default application (uses xdg-open on Linux, open on macOS, start on Windows)
  • Inline image display with Chafa: Automatically render images (PNG, JPEG, GIF, WebP) as ANSI art in the terminal
  • Requires chafa.py optional dependency (install with pip install astronomo[chafa] or uv tool install astronomo --with chafa.py)
  • Toggle display in Settings → Appearance → Show Images (off by default)
  • Quality settings: Low, Medium (default), High - controls dithering and rendering detail
  • LRU cache: Stores up to 10 images (100MB max) in ~/.cache/astronomo/images/ for fast history navigation
  • Download button on each image to save original file to ~/Downloads
  • Respects max_content_width setting for image sizing
  • Graceful fallback: If Chafa unavailable or rendering fails, falls back to binary download
  • Extensible media detection system ready for future audio/video support

Changed

  • Preformatted code blocks now respect max_content_width setting and are centered on screen like other content

Fixed

  • Browser tab title now updates when navigating back/forward in history
  • Refresh (Ctrl+R) now properly updates history: navigating away and back after refreshing a page now shows the refreshed content instead of the stale cached version
  • Chafa (inline images) is now a proper optional dependency installable via pip install astronomo[chafa] instead of only being available in development mode
  • Added documentation for Chafa installation in installation guide, README, and changelog
  • Inline image display now works when servers return text/gemini MIME type for image URLs (detection now also checks file extension)
  • Inline images now render with correct aspect ratio (uses calc_canvas_geometry with terminal font ratio ~0.5)
  • Image widget is now properly removed when navigating away from an image page
  • Image quality setting in Appearance settings now correctly initializes (fixed Select widget options order)
  • Relative links now resolve correctly after server redirects (e.g., navigating to /~user which redirects to /~user/ no longer breaks relative links like ./about.gmi)
  • Back navigation now works correctly after downloading binary files (download pages are properly added to history)
  • Back navigation now works correctly from error pages (timeout, connection errors are properly added to history)
  • Command-line URLs with explicit protocols (e.g., astronomo gopher://...) are no longer incorrectly prefixed with gemini://
  • Known Hosts settings tab now correctly handles hostnames with periods (e.g., station.martinrue.com) by sanitizing widget IDs
  • Binary files (images, audio, etc.) over Gemini are now properly downloaded to ~/Downloads instead of crashing when trying to parse them as Gemtext

0.5.0 - 2025-12-31

Added

  • Quick navigation modal (Ctrl+K): Keyboard-driven fuzzy finder for quickly jumping to bookmarks and history entries
  • get_all_entries() method in HistoryManager to retrieve all history entries
  • Identity prompt behavior setting: control when the identity selection modal appears via Settings > Browsing. Options are "Every time" (always prompt), "When ambiguous" (auto-select if one match, prompt if multiple), and "Remember choice" (never prompt, reuse previous selection). Session identity choices are now persisted to disk and restored on app restart
  • Emoji display mode setting: toggle between showing Unicode emoji or text descriptions (e.g., (grinning face)) in Settings > Appearance
  • Max content width setting: limit text content to a configurable width (default 80 characters) with automatic centering. Preformatted blocks and code are excluded from the limit. Set to 0 to disable
  • Settings button (cog icon) in the navigation bar for quick access to settings
  • Folder color customization: set custom background colors for bookmark folders via the Edit Folder dialog
  • Color picker with 12 preset colors (6 muted, 6 pastel) and custom hex input support
  • Automatic text contrast for folder names on colored backgrounds
  • Bookmarks sidebar items are now clickable: clicking a bookmark opens it, clicking a folder toggles expand/collapse
  • Page snapshot save feature (Ctrl+S): Save current page as a .gmi file with configurable directory
  • Improved error handling for snapshot saves with user-friendly notifications
  • Better hostname sanitization for snapshot filenames (prevents filesystem issues)
  • Import identities from Lagrange browser: Settings > Certificates now includes an "Import from Lagrange" button that discovers and imports existing Lagrange client certificates
  • Import custom certificates: Settings > Certificates now includes an "Import Certificate" button to import existing certificate/key files. Supports both separate cert+key files and combined PEM files containing both certificate and private key. Includes a file browser for easy selection
  • RSS/Atom feed subscription and management (Ctrl+J to open feeds screen)
  • Feed folder organization for organizing subscriptions
  • Read/unread tracking for feed items
  • OPML import/export for feed portability (Ctrl+I/Ctrl+E in feeds screen)
  • Search/filter functionality for feeds
  • Feed refresh on-demand

Changed

  • All modal dialogs now use centered border titles instead of internal label titles for a cleaner, more consistent UI
  • Settings screen now uses border title instead of internal header
  • URL bar (Address input) now has a border title
  • Feeds screen search input now has a border title
  • Switched type checker from mypy to ty for faster type checking
  • Refactored test suite to use shared pytest fixtures, reducing code duplication across test files
  • CI workflow now only publishes to PyPI on version tags, with TestPyPI as a prerequisite step
  • Feeds screen: Replaced button toolbar with keyboard bindings shown in footer for UI consistency
  • Feeds screen: Fixed contrast issues by using $surface instead of $primary for header and panel titles
  • Feeds screen: Ctrl+J now toggles the feeds screen (closes it when already open)
  • Feeds screen: Moved search box to top of feed list column for cleaner layout
  • Feeds screen: Removed redundant "Feeds" title from sidebar, now shown as border title
  • Feeds screen: Added TAB to toggle focus between feed list and first feed item
  • Feeds screen: Feed items now individually focusable with arrow key navigation
  • Feeds screen: Panel borders highlight when focused/contains focus
  • Feeds screen: Feed item timestamps now shown as human-readable relative time (e.g., "2 hours ago") in border title using humanize library

Fixed

  • Settings modal tab navigation no longer stops on invisible scroll containers
  • Feed items panel crash when opening a feed with a description
  • Feed item summaries now properly stripped of HTML tags and entities
  • URL bar now updates when navigating to a page from feeds screen
  • Feed item dates now correctly timezone-aware, future dates show as "today"

0.4.0 - 2025-12-02

Added

  • Documentation site with MkDocs
  • Session-based identity selection: When navigating to a site with matching identities, a modal prompts users to select which identity to use or browse anonymously. The choice persists for the session (until app quits)
  • get_all_identities_for_url() method in IdentityManager to retrieve all matching identities for a URL

Fixed

  • Home page from config is now properly loaded on startup

0.1.0 - 2025-01-05

Added

  • Initial release
  • Interactive link navigation with keyboard and mouse
  • Styled Gemtext rendering (headings, links, lists, blockquotes, preformatted)
  • History navigation (back/forward) with scroll position preservation
  • Bookmarks system with folder organization
  • Configuration file support (~/.config/astronomo/config.toml)
  • Interactive input support for status 10/11 responses (search, passwords)
  • Client certificate/identity management
  • Syntax highlighting for preformatted code blocks
  • Theme support via Textual themes