bulletty is a terminal-based user interface (TUI) feed reader designed for managing RSS and ATOM feeds efficiently. This innovative tool allows users to read subscriptions directly within the terminal, ensuring that all articles are stored locally in Markdown format for easy access and offline reading.

Key Features

• Feed Subscription: Effortlessly subscribe to both RSS and ATOM feeds, centralizing all content in one convenient location.
• Data Ownership: All data, including subscriptions, highlights, and comments, is stored locally, providing complete control over personal content.
• Offline Access: Articles are downloaded for offline reading, ensuring that access is not dependent on an internet connection.
• Markdown Rendering: Enjoy seamless reading experience with Markdown rendering for articles.
• Active Development: The project is continuously evolving, integrating user feedback for ongoing enhancements.

Usage Overview

To get started with bulletty, users can add new feed sources directly through the command line interface (CLI). Example command for adding a feed source:

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

Without specifying a category, the feed will be added to the default 'General' category. Syncing all sources is as simple as invoking bulletty. Alternatively, update entries by executing:

bulletty update

Command Navigation

bulletty features intuitive command navigation. Pressing the ? key provides command options for the current screen, while navigation keys allow for fluid movement through content:

• Use j/k or arrow keys for item selection.
• g/G/Home/End to quickly navigate to the beginning or end of lists.
• The Enter key opens entries, and q/Esc exits to previous views. To open an entry externally, simply press o.

Philosophy

The essence of bulletty lies in fostering a decentralized internet, empowering users to subscribe to their favorite sources and possess their content in a format that is easily manageable. Each article is saved as a Markdown file, allowing for flexible reading options within the embedded reader or any text editor.

Data is organized within the directory structure located at $HOME/.local/share/bulletty/, making it straightforward to synchronize all content akin to an Obsidian vault.

bulletty is an open-source project welcoming contributions to enhance its features. For further details on how to contribute, see the project’s CONTRIBUTING.md.