bulletty

crocidbMIT活跃维护

一款用 Rust 写的终端 RSS 阅读器,界面清爽,把订阅文章直接存成 Markdown 文件,方便本地管理和二次编辑。

bulletty is a pretty feed reader for the terminal that stores the articles as Markdown

v0.3.0发布于 2026-08-06 23:55 UTC447star28fork同步于 2026-11-07 07:33 UTC

怎么上手

由 README 提炼,执行前请确认
pacman -S bulletty
brew install bulletty
cargo install bulletty
硬件要求按 README 说明

README 未说明硬件要求;需使用 Kitty、Ghostty、Alacritty、WezTerm 等现代终端并安装 NerdFont 字体

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

终端里的 RSS/Atom 阅读器,把订阅文章存成本地 Markdown 文件,数据完全归你

一款用 Rust 写的终端 RSS 阅读器,界面清爽,把订阅文章直接存成 Markdown 文件,方便本地管理和二次编辑。

核心能力

  • 订阅 RSS 与 Atom 两类源并自动下载新条目
  • 所有源与文章以 Markdown 存于 ~/.local/share/bulletty/
  • 内置终端 Markdown 阅读器,支持 Read Later 分类
  • 支持 OPML 导入导出订阅列表
  • 可配置打开前后执行的 hooks 用于同步或打开链接

容易踩的坑

用 Cargo 安装需 cargo 1.90+;新增订阅源目前只能通过 CLI 的 bulletty add 命令;Windows 上构建需处理 openssl 依赖,可能需安装 Strawberry Perl 并设置 OPENSSL_SRC_PERL

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.3.0
  1. v0.3.0最新正式版2026-08-06 · 2026-08-06 23:55 UTC

    🎉 bulletty v0.3.0 is finally out!

    This is the most packed release ever! With parallel requests, updating the feeds is fast. A library with 50+ feeds can be updated in a matter of a couple seconds now. So many improvements to the general navigation in the TUI, especially from caching the Library, made the TUI feel as fluid as it can get. The interface also got an indication of unread articles per feed and a feed source status bar can give more context of your library. The reader now has support for code highlighting, as well as other improvements to markdown rendering. bulletty now supports user themes, defined in the library, opening possibilities for future procedural theming like matugen. Also, catpuccin was introduced in two flavors: Latte and Mocha. Although not yet a first-class citizen, but now mouse scroll work when running bulletty from tmux. We introduced hooks to bulletty, just points in the app where the user can hook their own tools, something essential to automate a library backup, as I explained here. Many issues with requests, rendering and interaction were also fixed.

    This work couldn't be possible without the help of all our contributors. Thanks for making bulletty a better piece of software.

    🆕 What's Changed

    New Contributors

    Gallery

    Install with Cargo

    cargo install bulletty
    

    Install prebuilt binaries via shell script

    curl --proto '=https' --tlsv1.2 -LsSf https://github.com/crocidb/bulletty/releases/download/v0.3.0/bulletty-installer.sh | sh
    

    Install prebuilt binaries via powershell script

    powershell -ExecutionPolicy Byp
    
  2. v0.2.22026-02-28 · 2026-02-28 16:54 UTC
    查看更新说明

    🎉 bulletty v0.2.2 is released with new features and bug fixes. We have a new theme (by @NikolaM-Dev); a notification system that gives feedback on some operations (such as adding or removing article to the Read Later category); adding feeds from their home-pages, that means bulletty will find the feed within an HTML page (by @jlledo); the screens are now rendered even without any input from the user, so the update progress bar will nicely move (by @jlledo); better layout distribution in the statusbar; and a nice welcome dialog explaining how to add feeds to your library, when the library is empty.

    Thanks @NikolaM-Dev and @jlledo for their contributions to bulletty v0.2.2. 🎊

    🆕 What's Changed

    Crates Updated

    New Contributors

    Full Changelog: https://github.com/CrociDB/bulletty/compare/v0.2.1...v0.2.2

    Install

    Install prebuilt binaries via shell script

    curl --proto '=https' --tlsv1.2 -LsSf https://github.com/CrociDB/bulletty/releases/download/v0.2.2/bulletty-installer.sh | sh
    

    Install prebuilt binaries via powershell script

    powershell -ExecutionPolicy Bypass -c "irm https://github.com/CrociDB/bulletty/releases/download/v0.2.2/bulletty-installer.ps1 | iex"
    

    Download bulletty 0.2.2

    FilePlatformChecksum
    bulletty-aarch64-apple-darwin.tar.xzApple Silicon macOSchecksum
    bulletty-x86_64-apple-darwin.tar.xzIntel macOSchecksum
    [bulletty-x86_64-pc-windows-msvc.zip](https://gith
  3. v0.2.12026-01-15 · 2026-01-15 14:35 UTC
    查看更新说明

    🎉 Happy New Year!

    This is the first official release of bulletty in 2026! It's mostly bug fixes, but at least one important thing has been changed: the article's metadata are now separated by +++ rather than ---. That's because the former is more commonly used to indicate the metadata is in TOML, not YAML, as the latter. The reader is still capable to read old files still separated with ---, though, so nothing is gonna be broken.

    We fixed YouTube video links. If you subscribed to YouTube channels, you might have noticed that the URL is not what you expected it to be, what made it pretty much impossible to open the video on the browser. The fetching is fixed, but old feed entries with the wrong URLs will continue to be wrong. If you want that to be fixed, delete all the entries straight in the subscription path in your local library, once you start bulletty, it will automatically re-fetch those items with the correct URL.

    Windows and Mac can now finally generate logs. The version for Windows was crashing displaying the directories (bulletty dirs) due to the log directory we were using was invalid. Throughout the execution, however, it was just simply not logging. Now both platforms should generate their own logs.

    🆕 What's Changed

    Crates updated

  4. v0.2.02025-11-07 · 2025-11-07 13:52 UTC
    查看更新说明

    bulletty v0.2.0 released! 🎉

    One of the biggest releases yet! New stuff:

    • Read Later: you can now add articles to that category by pressing L and access that at the end of the feed tree.
    • Customizable Feed Tree width: change the width of the feed tree by pressing < or >
    • Customizable Reader Width: change the width of the reader also with < and >
    • Many improvements to the reader: many issues with newlines; images representation; code blocks; etc.
    • Themes: support for themes was added along with many beautiful ones. Press t to select the theme that suits you best
    • New logo: now bulletty officially has a logo. It's a mix of the RSS logo with some >> to indicate a prompt. Share you thoughts on it

    Install

    You can install that from the built binaries in this page, or with cargo (1.90+):

    cargo install bulletty
    

    Changelog

    Full Changelog: https://github.com/CrociDB/bulletty/compare/v0.1.9...v0.2.0

  5. v0.1.92025-10-11 · 2025-10-11 15:17 UTC
    查看更新说明

    What's Changed

    Contributors

    • @alfaarghya
    • @tanmayc07
    • @CrociDB

    Full Changelog: https://github.com/CrociDB/bulletty/compare/v0.1.8...v0.1.9

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    bulletty is a TUI feed reader and aggregator (RSS and Atom). Read your subscriptions directly in your terminal. It downloads the entries for offline reading so all the data is local and yours: your subscriptions, highlights, comments, etc. All in a universal format: Markdown. Back up and sync your data directory your own way.

    It's in active development.

    🔨 Features

    • Subscribe to RSS and Atom feed types
    • All your feed sources and entries are stored in Markdown in one place: $HOME/.local/share/bulletty/
    • Automatically download new entries
    • Add articles to the Read Later category
    • Read articles with the embedded cozy Markdown reader
    • Import/export OPML feed list
    • Supports multiple beautiful colorful themes
    • Hooks: you can set hooks to sync your feed library before bulletty opens and after it closes; or tell it how to open links

    🚀 Install

    Download bulletty pre-built binaries

    🐧 Arch Linux (and derivatives like Manjaro, Parabola)

    pacman -S bulletty
    

    🍺 Homebrew (macOS / Linux)

    brew install bulletty
    

    ❄️ Nix

    nix profile install nixpkgs#bulletty
    

    Or using the traditional command:

    nix-env -iA nixpkgs.bulletty
    

    🚩 NetBSD

    pkgin install bulletty
    

    📦 Snap

    bulletty

    sudo snap install bulletty
    

    🚚 Through Cargo

    It requires cargo 1.90+:

    cargo install bulletty
    

    To install the latest version in the repository:

    cargo install --git https://github.com/CrociDB/bulletty.git
    

    ☂️ Pre-requisites

    bulletty runs in most platforms, however there are some pre-requisites to have it run the best way possible:

    • Use a modern terminal emulator such as Kitty, Ghostty, Alacritty, WezTerm, Windows Terminal, etc. They provide modern features and true color support, and are usually very fast and hardware-rendered
    • Use a NerdFont. They are patched versions of common coding fonts with several icons

    🚄 Usage

    🗞️ Adding new feed sources

    For now, you can only add new feed sources via the CLI:

    bulletty add https://crocidb.com/index.xml [Category]
    

    If no category is passed, the feed source will be added to the General category. bulletty will synchronize all your sources when you open the TUI, by just invoking bulletty.

    More on the CLI commands with:

    bulletty help
    

    🧩 TUI

    On any screen, you can press question mark ? and it will show you the available commands for that screen. Also, on the bottom right, it shows the most important commands for that context.

    In general, it supports j/k/up/down to select items, navigate and scroll, as well as g/G/Home/End to go to the beginning/end of a list or file and Enter and q/Esc to navigate into and out of Categories and Entries. In order to open an Entry externally, press o.

    💌 Don't know what to subscribe to?

    HN Personal Websites is a good repository of blogs that constantly show up on Hacker News. Subscribing to all of them is simple:

    wget https://hnpwd.github.io/hnpwd.opml
    bulletty import hnpwd.opml
    

    🏫 Philosophy

    The whole idea is to help bring back the decentralized internet. You subscribe to the sources you like the most and you get their content whenever it's available. When you get it, it's local, it's yours. bulletty will generate a Markdown file of each entry from each source. You can read through the embedded reader, directly in your terminal, or using any text editor.

    All your feed data will be at $HOME/.local/share/bulletty/, in this structure:

    [~/.local/share/bulletty]$ tree
    .
    └── categories
        ├── Programming
        │   ├── bruno-croci
        │   │   ├── .feed.toml
        │   │   ├── about.md
        │   │   ├── demystifying-the-shebang-kernel-adventures.md
        │   │   ├── from-ides-to-the-terminal.md
        │   │   ├── i-wrote-a-webserver-in-haskell.md
        │   │   ├── ...
        ├── General
        │   ├── another-website
        │   │   ├── .feed.toml
        │   │   ├── some-post.md
        │   │   ├── ...
    
    

    All that needs to be done is to synchronize the bulletty directory to save your data, similar to an Obsidian vault.

    ✂️ Third Party Tools

    One of the nice things about this open data structure is that people can build external tools that interact with the bulletty feed library.

    📜 Feature Roadmap

    • Highlight
    • Notes
    • Web view
    • Mouse support
    • Image support
    • PDF/Epub article export

    💻 Build

    git clone https://github.com/CrociDB/bulletty.git
    cd bulletty
    cargo build --release
    

    Build with nix is also possible with:

    nix run .#release
    

    Notes on building on Windows

    bulletty requires the openssl crate to build, but it's known to be a little complicated to build on Windows. If it fails on a regular build, it's probably because whatever perl version it's trying to use is not suitable to build it. In that case, try installing Strawberry Perl and make sure that openssl uses the one you just install to build:

    $env:OPENSSL_SRC_PERL = "C:\Strawberry\perl\bin\perl.exe"
    

    Then cargo build should work normally.

    👩‍💻 Contributing to bulletty

    I am very open to contributions to help make bulletty the best feed reader out there. For more information on how to contribute, refer to the CONTRIBUTING.md.

    📃 License

    Copyright (c) Bruno Croci

    This project is licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT)