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
• theme — UI theming with 15 popular color schemes
• ui — Terminal UI rendering and input handling

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 theme::Theme;

pub use theme::ThemeName;

pub use theme::ThemePalette;

pub use update::PackageManager;

pub use update::VersionCheck;

pub use update::check_for_updates;

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.

theme

Theme configuration and colors.

ui

Terminal UI components.

update

Update checking and self-update functionality.