tuifeed
Developed by @veeso
Current version: 0.1.1 (17/11/2021)
~ A terminal news feed reader with a fancy ui ~
π°
About tuifeed tuifeed is a news feed reader with a fancy terminal user interface. It allows you read news from your favourite RSS and Atom sources, which can be easily configured in a TOML file.
π
Features -
π° Read feed from any RSS/Atom source -
π Open any article in your favourite browser in one-click -
π§ Compatible with Windows, Linux, *BSD and MacOS -
π€ Easy setup -
π¦ Rust-powered
π
Get started
π
Installation
π₯οΈ
Shell script You can directly install tuifeed with this simple shell script:
curl --proto '=https' --tlsv1.2 -sSLf "https://git.io/J1O0Z" | sh
-
π§ GNU/Linux -
π MacOS -
π© NetBSD
β If you don't trust the script, you can view its content on Github
π«
Windows users You can install tuifeed on Windows with Chocolatey:
choco install tuifeed
π¦
Cargo installation You can opt to install tuifeed with Cargo:
cargo install --locked tuifeed
Configure your news feed
Once installed, in order to start using tuifeed, the first thing you need to do is to configure the feeds you want to read from.
To open the configuration file you can run
tuifeed -c
this will open the configuration file in your favourite editor.
β If this option doesn't work for your, you can edit the file manually at:
~/.config/tuifeed/config.toml
on Linux/Users/$USER/Library/Application\ Support/tuifeed/config.toml
on MacOS
then you can add new sources as follows:
[sources]
"Corriere Della Sera" = "http://xml2.corriereobjects.it/rss/homepage.xml"
"Dev.to" = "https://dev.to/feed/"
"Hacker News" = "https://hnrss.org/newest"
"Il Piccolo" = "https://ilpiccolo.gelocal.it/rss/finegil/ilpiccolo/feed.rss"
"Il Post (Mondo)" = "https://www.ilpost.it/mondo/feed/"
"Il Post (Italia)" = "https://www.ilpost.it/italia/feed/"
"Messaggero Veneto" = "https://messaggeroveneto.gelocal.it/rss/finegil/messaggeroveneto/feed.rss"
"New York Times" = "https://rss.nytimes.com/services/xml/rss/nyt/World.xml"
so for each feed you want to read from, you must put an entry with a key, which identifies the Name of the source as it'll be displayed in the UI associated to the URL of the feed.
πͺ If you want to use special characters in toml you can quote the key name:"Il Post (Mondo)" = "https://www.ilpost.it/mondo/feed/"
Once you're done with configuration, save, close and enjoy tuifeed
β¨οΈ
Keybindings Key | Where | Description |
---|---|---|
Tab, Right | Feed list | Move to article list |
Up, Down, PageUp, PageDown | Feed list, article list | Scroll up/down in list |
Home, End | Feed list, article list | Go to the beginning/end of the list |
R | Feed list | Reload selected source |
CTRL+R | Feed list | Reload all sources |
Tab, Left | Article list | Move to feed list |
Right | Article list | Move to article summary |
Left | Article summary | Move to article list |
Up, Down, PageUp, PageDown | Article summary | Scroll up/down in summary |
Home, End | Article summary | Go to the beginning/end of summary |
Enter | Article summary, article link | Open selected article url in your favourite browser |
Esc | * | Quit tuifeed |
β
Support the developer If you like tuifeed and you're grateful for the work I've done, please consider a little donation
You can make a donation with one of these platforms:
πͺ
Powered by
Contributing and issues π€π»
Contributions, bug reports, new features and questions are welcome!
Please follow our contributing guidelines
β³
Changelog View tuifeed's changelog HERE
π
License tuifeed is licensed under the MIT license.
You can read the entire license HERE