Skip to content

Quick Start

This guide will get you browsing Geminispace in under 5 minutes.

Launching Astronomo

Open your terminal and run:

astronomo

Or navigate directly to a URL:

astronomo gemini://geminiprotocol.net/

Basic Navigation

Opening URLs

  1. Type or paste a URL in the address bar at the top
  2. Press Enter to navigate
  3. You can omit gemini:// - it's added automatically

Links are highlighted in the content area. Navigate them with:

Key Action
Left / Right Move between links
Enter Open selected link
Mouse click Open link directly

History Navigation

Key Action
Backspace Go back
Shift+Backspace Go forward
Back/Forward buttons Click the ◀ ▶ buttons

Managing Bookmarks

Adding Bookmarks

Press Ctrl+D to bookmark the current page. A dialog appears where you can:

  • Edit the bookmark title
  • Choose a folder (or leave in root)

Viewing Bookmarks

Press Ctrl+B to toggle the bookmarks sidebar. From here you can:

  • Click a bookmark to navigate
  • Right-click for options (edit, delete)
  • Expand/collapse folders

Other Key Commands

Key Action
Ctrl+Q Quit Astronomo
Ctrl+R Refresh current page
Ctrl+, Open settings

Configuration

Astronomo stores its configuration at ~/.config/astronomo/config.toml. The default configuration looks like:

[appearance]
theme = "textual-dark"

[browsing]
timeout = 30
max_redirects = 5

See Configuration Reference for all options.

Next Steps