📘 srss

A fast & simple command line RSS/ATOM/JSON feed reader written in Go, inspired by newsboat

Language:Go License:MIT

This repository is still under development!. Specifications are subject to change without notice.


  • Fast, efficient, and easy-to-use interface for CLI lovers
  • Supports multiple feed format: RSS, Atom and JSON


Commands and Options

   srss - A simple command line RSS feed reader

   srss [global options] command [command options] [arguments...]

   open, o  Open feed URL on your browser
   add, a   Add url entry
   edit, e  Edit URL entry file
   tui, t   View items in the feed with built-in pager
   help, h  Shows a list of commands or help for one command

   --help, -h  show help (default: false)

Register or edit the feeds URL

Use the add command to register the feed URL.

The feeds URL is saved in a plain text file and you can edit it using the edit command. You can specify the command name of the editor in the argument of the -e, --editor option. If the environment variable $EDITOR is set, will use it.

srss add
srss edit --editor nvim

View items in the feed on the terminal

Run the tui, t command then narrow down and select the items in the feed with a fuzzyfinder-like UI, you can browse the items with a less like pager UI.

srss tui

The key bindings in fuzzyfinder UI are follows:

Key Description
C-k C-p Move focus up
C-j C-n Move focus down
Enter Select the item
q Esc Quit fuzzyfinder

The key bindings in pager UI are follows:

Key Description
k Up Scroll up
j Down Scroll down
g Home Scroll on top
G End Scroll on bottom
q Esc Quit pager then back to fuzzyfinder

Open links on items in the feed in the browser

Use the open, o command, you can open the link of the selected item in your browser. You can select multiple items with Tab key.

srss open


To build from source, clone this repository then run go install. Developing with Go v1.18.2 linux/amd64


Welcome any bug reports, requests, typo fixes, etc.






View Github