lazyfeed is a dead simple terminal base RSS/Atom reader built using textual.
Project description
lazyfeed
lazyfeed
is a dead simple terminal base RSS/Atom reader built using Textual.
Features
- Save posts for later.
- Mark posts as favorite.
- Vim-like keybindings.
- Custom configuration.
- Filtering (Coming soon).
- Theming (Coming soon).
- In-App view (Coming soon).
- Docker support (Coming soon).
lazyfeed
is a personal project, and the features I will be working on are tailored to my own needs and preferences at the moment.
Motivation
I wanted a simple and fast way to follow RSS feeds directly in my terminal, without relying on services like Feedly or similar platforms. While existing tools like newsboat and nom are available and there are more mature, I wanted to create my own, and here it is.
Install
There are several ways to install lazyfeed
:
Via pip
pip install lazyfeed
Via pipx
pipx install lazyfeed
Via uv
uv tool add lazyfeed
# Or
uvx lazyfeed
Usage
For a better experience using a nerd font is recommended.
lazyfeed add https://dnlzrgz.com/rss # Add a feed.
lazyfeed add https://dnlzrgz.com/rss https://www.theverge.com/rss/index.xml # Add multiple feeds at once.
lazyfeed import feeds.opml # Import from an OPML file.
lazyfeed # Start the TUI
In addition to importing, you can also export all your feeds using the export command. Run
lazyfeed export --help
for more information.
Keybindings
General
?
: Display/Close help message.q/esc
: Quit.r
: Refresh.
Navigation
j/n
: Move to next post.k/p
: Move to previous post.gg/G
: Jump to first/last post.gp/gn
: Pending/New posts.ga
: All posts.gl
: Saved posts.gf
: Posts marked as favorite.
Posts
o/enter
: Open link in browser and mark post as read.x
: Mark post as read.m
: Mark post as read without removing it.s
: Save post for later.f
: Mark post as favorite.shift+a
: Mark all posts as read.
Configuration
If you need to, you can customize some aspects of lazyfeed
via the config.toml
file located at $XDG_CONFIG_HOME/lazyfeed/config.toml
. This file is generated the first time you run lazyfeed
and looks something like this:
# Welcome! This is the configuration file for lazyfeed.
[app]
# If set to true, all posts will be marked as read when quitting the application.
auto_mark_as_read = false
# If set to true, items will be marked as read without asking for confirmation.
ask_before_marking_as_read = false
[client]
# Maximum times (in seconds) to wait for all request operations.
timeout = 300
# Timeout for establishing a connection.
connect_timeout = 10
[client.headers]
# This section defines the HTTP headers that will be sent with
# each request.
# User-Agent = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
# Accept = "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8"
# Accept-Language = "en-US,en;q=0.6"
# Accept-Encoding = "gzip,deflate,br,zstd"
# Welcome! This is the configuration file for lazyfeed.
This folder will also contain the SQLite database where all the data will be stored.
To open the config.toml
file, you can just run the following command:
lazyfeed config
Dependencies
Screenshots
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lazyfeed-0.1.25-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6cce95c34032f7a721d29dd0dde5991286ecbc3010b7e16d606c0ff3d0d86aff |
|
MD5 | ad431dcb328ba950dd75e96a192703ce |
|
BLAKE2b-256 | a2fc44e44b2ed639c3fe013db6c065bc3f57372fb822778cc81b88bd70aa9ac9 |