Crate feedo 

Feedo 🐕

A stunning terminal RSS reader built with Rust.

Overview

Feedo is a modern, fast, and beautiful terminal-based RSS/Atom feed reader. It provides a three-panel interface inspired by desktop readers like Reeder, but designed for the command line.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                          App                                │
│  Orchestrates all components and runs the main event loop   │
└─────────────────────────────────────────────────────────────┘
                             │
         ┌───────────────────┼───────────────────┐
         ▼                   ▼                   ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│     Config      │ │  FeedManager    │ │       UI        │
│                 │ │                 │ │                 │
│ • Load/Save     │ │ • Fetch feeds   │ │ • Render panels │
│ • Folders       │ │ • Parse RSS     │ │ • Handle input  │
│ • Theme         │ │ • Track state   │ │ • Search        │
└─────────────────┘ └─────────────────┘ └─────────────────┘
         │                   │                   │
         └───────────────────┴───────────────────┘
                             │
                   ┌─────────────────┐
                   │      OPML       │
                   │                 │
                   │ • Import feeds  │
                   │ • Export feeds  │
                   └─────────────────┘

Modules

• app — Main application state and event loop
• config — Configuration management and persistence
• feed — Feed fetching, parsing, and state management
• opml — OPML import/export for feed migration
• sync — Sync with FreshRSS, Miniflux via Google Reader API
• ui — Terminal UI rendering and input handling

Theme support is provided by the ratatui_themes crate.

Example

use feedo::App;

#[tokio::main]
async fn main() -> color_eyre::Result<()> {
    let mut app = App::new().await?;
    app.run().await
}

Features

• Beautiful TUI — Clean three-panel interface with ratatui
• Folder Organization — Group feeds with custom emoji icons
• Instant Search — Find articles across all feeds
• 15 Themes — Dracula, Nord, Catppuccin, Gruvbox, Tokyo Night, and more
• OPML Support — Import/export for easy migration
• Social Sharing — Share articles to X, Mastodon, and Bluesky
• Async — Non-blocking feed fetching with Tokio
• Cross-Platform — Works on Linux, macOS, and Windows

Re-exports

pub use app::App;

pub use config::Config;

pub use error_report::REPO_URL;

pub use error_report::VERSION;

pub use error_report::create_issue_url;

pub use error_report::open_issue;

pub use feed::CacheStats;

pub use feed::CachedFeed;

pub use feed::CachedItem;

pub use feed::DiscoveredFeed;

pub use feed::Feed;

pub use feed::FeedCache;

pub use feed::FeedDiscovery;

pub use feed::FeedItem;

pub use feed::FeedManager;

pub use feed::FeedType;

pub use sync::GReaderClient;

pub use sync::SyncConfig;

pub use sync::SyncManager;

pub use sync::SyncProvider;

pub use sync::SyncResult;

pub use update::PackageManager;

pub use update::VersionCheck;

pub use update::check_for_updates;

pub use update::check_for_updates_crates_io;

pub use update::check_for_updates_timeout;

pub use update::detect_package_manager;

pub use update::run_update;

Modules

app

Main application module.

config

Configuration management.

credentials

Secure credential storage using AES-256-GCM encryption.

error_report

Error reporting utilities.

feed

Feed management and fetching.

opml

OPML import and export.

sync

Sync support for external RSS services.

ui

Terminal UI components.

update

Update checking and self-update functionality.

Structs

Theme

A theme configuration wrapper providing convenient access to theme colors.

ThemePalette

A semantic color palette for a theme.

Enums

ThemeName

Enumeration of all available color themes.