Two kinds of feeds. Two different jobs.
Podcasts and RSS both begin with a feed URL, but forcing them into one reader would make both worse. Podcasts need playback and progress. RSS needs filtering, formatting, and a compact place to read updates.
Podcasts stay on the home screen
Run podcast to open the podcast surface over Launcher. It can minimize into an edge pill instead of taking the whole home screen with it. Run the command again, or tap the pill, to expand it.
podcast add https://example.com/feed.xml podcast refresh podcast play
Subscriptions must use HTTPS. RETUI downloads RSS or Atom feed data, streams episode audio from the publisher, and keeps subscriptions, progress, playback speed, tags, and played state locally.
Playback belongs to the existing media surface
podcast playPlay or pause the selected episode.
podcast next / prevMove through the selected show's ordered episodes.
podcast speed 1.25Choose a playback speed from 0.5× through 2.0×.
podcast closeClose the podcast surface when you are done.
A first-time listener starts with the oldest episodes. The selected show can be changed to newest-first, and the current episode title appears through the Music module because podcast audio uses the same Launcher playback service.
RSS is the text-and-rules side
Run rss -add for the setup form, or provide an ID, refresh interval, and feed URL directly. Saved feeds can be renamed, refreshed, shown or hidden, limited to Wi-Fi, and given their own colour or format.
rss -add 1 900 https://www.reddit.com/r/android/.rss rss -frc 1 rss -ls rss -l 1
rss -ls opens the feed list, where an entry can be edited. rss -file opens the underlying local rss.xml when direct configuration is the shorter path.
Filtering matters once a feed gets noisy
rss -include_if_matches <id> <regex>Keep entries that match a saved or inline pattern.
rss -exclude_if_matches <id> <regex>Hide matching entries from that feed.
rss -wifi_only <id> trueRefresh the feed only while Wi-Fi is connected.
rss -last_check <id>Inspect when RETUI last checked it.
Feed formats and regex rules remain inspectable local configuration. The articles and audio still come from their publishers, so requesting them contacts those external servers.
Put updates in the dock when they deserve the space
module -dock add rss module -show rss
The module is for glanceable updates. The full feed list and podcast surface stay available when you need more room. That is the same boundary RETUI uses elsewhere: small state in the dock, focused work in its own surface.
A feed should bring something useful into the Launcher without turning the Launcher into another endless timeline.