# bulletty

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

Stars: 453 · Language: Rust · License: MIT · Categories: Productivity

- Repository: https://github.com/crocidb/bulletty
- Website: http://bulletty.croci.dev/
- Page: https://www.trmn.sh/tools/bulletty

## Install

- Homebrew: `brew install bulletty`
- Cargo: `cargo install bulletty`
- Snap: `sudo snap install bulletty`

## Overview

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

```bash
# via Homebrew
brew install bulletty
```

```bash
# via Cargo
cargo install bulletty
```

```bash
# via Snap
sudo snap install bulletty
```

![bulletty TUI feed reader in action](https://media.trmn.sh/cached/b0e2c543d022d774828278799414d81dd637ec2d43965255c1d4a344d85910d6.gif)

## Alternatives

- [russ](https://www.trmn.sh/tools/russ.md): TUI RSS/Atom feed reader with vim-style modal controls, a SQLite database for storage, and OPML import. Works fully offline. (Rust, 267 stars)
- [outside](https://www.trmn.sh/tools/outside.md): Terminal weather client with multiple output formats including TUI, JSON, and Waybar integration (Rust, 103 stars)
- [eilmeldung](https://www.trmn.sh/tools/eilmeldung.md): Terminal RSS/news reader in Rust built on the news-flash library, with vim-style keybindings, mouse support, an article query language and many RSS providers. (Rust, 1.1k stars)
- [basalt](https://www.trmn.sh/tools/basalt.md): Terminal user interface (TUI) for managing Obsidian vaults and notes from the command line (Rust, 1.4k stars)
- [kalker](https://www.trmn.sh/tools/kalker.md): Scientific calculator CLI with support for calculus, variables, functions, matrices, and multiple number bases (Rust, 1.9k stars)

## Guides

- [Best terminal RSS readers](https://www.trmn.sh/best/terminal-rss-readers): Compare newsboat, eilmeldung and nom, plus goread, GORSS, bulletty and russ, for reading RSS and Atom feeds in the terminal.

---

Canonical: https://www.trmn.sh/tools/bulletty
