RSS/Atom Feeds¶

This guide explains how to subscribe to, manage, and read RSS/Atom feeds in Astronomo.

Opening the Feeds Screen¶

Press Ctrl+J to open the feeds screen. Press Ctrl+J or Esc to close it and return to browsing.

Subscribing to Feeds¶

Adding a New Feed¶

Open the feeds screen (Ctrl+J)
Press Ctrl+N to add a new feed
Enter the feed URL (e.g., gemini://example.com/feed.xml)
Optionally edit the title
Optionally select a folder
Press Enter to save

Supported Feed Formats¶

Astronomo supports:

Atom feeds (recommended)
RSS 2.0 feeds
RSS 1.0 feeds

Most Gemini capsules that offer feeds use Atom format.

Finding Feeds¶

Popular Gemini feed aggregators:

gemini://warmedal.se/~antenna/ - Antenna (aggregates many gemlogs)
gemini://rawtext.club/~sloum/spacewalk.xml - Spacewalk
gemini://gemini.circumlunar.space/capcom/ - CAPCOM

Many gemlogs also offer their own feeds, typically at /feed.xml or /atom.xml.

Reading Feeds¶

The feeds screen has two panels:

Panel	Description
Feeds (left)	Your subscribed feeds organized by folder
Items (right)	Articles from the selected feed

Keyboard Controls¶

Key	Action
`Tab`	Switch focus between feeds list and items
`Up` / `Down`	Navigate within current panel
`Enter`	Open selected feed or article
`Esc` or `Ctrl`+`J`	Close feeds screen

Viewing Feed Items¶

Select a feed from the left panel
Press Enter to load its items
Press Tab to move to the items panel
Use Up / Down to browse items
Press Enter to open an article in the browser

Each feed item shows:

Title - Article headline
Time - Human-readable timestamp (e.g., "2 hours ago", "yesterday")
Author - If provided by the feed
Summary - Brief description if available

Read/Unread Tracking¶

Unread items appear in normal text
Read items appear dimmed
Press M to mark all items in the current feed as read

Organizing Feeds¶

Creating Folders¶

Press Ctrl+F to create a new folder
Enter a folder name
Press Enter to save

Moving Feeds to Folders¶

Select a feed
Press E to edit
Select a folder from the dropdown
Press Enter to save

Editing Feeds¶

Select a feed
Press E to edit
Modify the title or folder
Press Enter to save

Deleting Feeds¶

Select a feed or folder
Press D to delete
Confirm deletion

Warning

Deleting a folder moves its feeds to the root level (they are not deleted).

Refreshing Feeds¶

Key	Action
`Ctrl`+`R`	Refresh selected feed
`Ctrl`+`Shift`+`R`	Refresh all feeds

Searching Feeds¶

Use the search box at the top of the feeds list to filter feeds by name or URL.

OPML Import/Export¶

OPML (Outline Processor Markup Language) allows you to transfer feed subscriptions between applications.

Importing Feeds¶

Press Ctrl+I to import
Enter the path to your OPML file
Press Enter to import

Feeds are imported with their folder structure preserved.

Exporting Feeds¶

Press Ctrl+E to export
Enter the destination path
Press Enter to export

The exported file can be imported into other feed readers.

Feed Storage¶

Feeds are stored in ~/.config/astronomo/feeds.toml:

[[folders]]
id = "abc123"
name = "News"
created_at = "2025-01-15T10:30:00"

[[feeds]]
id = "def456"
url = "gemini://warmedal.se/~antenna/atom.xml"
title = "Antenna"
folder_id = "abc123"
created_at = "2025-01-15T10:30:00"
last_fetched = "2025-01-15T12:00:00"

Read state is stored separately in ~/.config/astronomo/feeds_read.toml.

Keyboard Reference¶

Feeds Screen¶

Key	Action
`Ctrl`+`J`	Close feeds screen
`Esc`	Close feeds screen
`Tab`	Toggle focus between panels
`Ctrl`+`N`	Add new feed
`Ctrl`+`F`	Add new folder
`Ctrl`+`R`	Refresh selected feed
`Ctrl`+`Shift`+`R`	Refresh all feeds
`Ctrl`+`I`	Import OPML
`Ctrl`+`E`	Export OPML
`D`	Delete selected item
`E`	Edit selected item
`M`	Mark all as read

Feed Items¶

Key	Action
`Up`	Previous item
`Down`	Next item
`Enter`	Open article

Tips¶

Start with aggregators - Subscribe to Antenna or CAPCOM to discover new content
Organize early - Create folders before adding many feeds
Check periodically - Feeds don't auto-refresh; use Ctrl+Shift+R to catch up
Export backups - Use OPML export to backup your subscriptions