bulletty

Terminal RSS/Atom feed reader that downloads entries for offline reading and stores feeds and articles as local Markdown files.

install

bulletty is a TUI feed reader and aggregator for RSS and Atom feeds. It downloads entries for offline reading and writes each one as a Markdown file under $HOME/.local/share/bulletty/, organized as categories/<Category>/<feed>/. Each feed directory holds a .feed.toml file plus one .md file per article, so the library can be read in the built-in Markdown reader or opened in any text editor.

Feeds are added from the CLI with bulletty add <url> [Category]. If no category is given, the feed goes into General. Running bulletty with no arguments opens the TUI and syncs all sources. OPML lists can be imported and exported, for example bulletty import hnpwd.opml. Inside the TUI, ? shows the commands for the current screen. Navigation uses j/k, g/G, Enter and q/Esc, and o opens an entry externally. Articles can be added to a Read Later category, and there are several color themes.

Because the data is plain files, you can back up or sync the directory with your own tools, much like an Obsidian vault. Hooks can run a sync command before bulletty opens and after it closes, and can also set how links are opened. The README lists a third-party script that exports Read Later articles to PDF. It also lists highlights, notes, image support and mouse support as planned features. The README recommends a terminal with true color support and a Nerd Font. The tool suits developers and terminal users who want to keep feed content in local, portable files.

Installation

# via Homebrew
brew install bulletty
# via Cargo
cargo install bulletty
# via Snap
sudo snap install bulletty

bulletty TUI feed reader in action

Alternatives & related tools

add a badge to your README

Maintain bulletty? Show that it's featured on trmn. The badge links back to this page.

Featured on trmn
Markdown
[![Featured on trmn](https://www.trmn.sh/badge/bulletty.svg)](https://www.trmn.sh/tools/bulletty?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/bulletty?utm_source=badge"><img src="https://www.trmn.sh/badge/bulletty.svg" alt="Featured on trmn" height="20"></a>