Feedr - Terminal RSS Feed Reader 📰

Feedr is a feature-rich terminal-based RSS feed reader written in Rust. It provides a clean, intuitive TUI interface for managing and reading RSS feeds with elegant visuals and smooth keyboard navigation.

✨ Features

• Dashboard View: See the latest articles across all your feeds
• Feed Management: Subscribe to and organize multiple RSS feeds
• Rich Content Display: Beautiful formatting of articles with HTML-to-text conversion
• Smart Search: Quickly find content across all your feeds
• Browser Integration: Open articles in your default browser

🚀 Installation

Prerequisites

• Rust and Cargo (install from https://rustup.rs/)

Using Cargo Install (Recommended)

cargo install feedr

Build from Source

git clone https://github.com/bahdotsh/feedr.git
cd feedr
cargo build --release

The binary will be available at target/release/feedr.

🎮 Usage

Run the application:

feedr

Quick Start

1. When you open Feedr for the first time, press a to add a feed
2. Enter a valid RSS feed URL (e.g., https://news.ycombinator.com/rss)
3. Use arrow keys to navigate and Enter to view items
4. Press o to open the current article in your browser

Keyboard Controls

General Navigation

Dashboard View

Feed List View

Feed Items View

Item Detail View

🧩 Dependencies

• ratatui: Terminal UI framework
• crossterm: Terminal manipulation
• reqwest: HTTP client
• rss: RSS parsing
• html2text: HTML to text conversion
• chrono: Date and time handling
• serde: Serialization/deserialization

📜 License

MIT

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request