Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


PyPI version

Terminal Feed is a minimal feed reader for the terminal (without curses).

To read, preview, open, store, or delete your favorite RSS feeds from the command line.


If 1) you are a terminal addict, and 2) you want to stay up to date with the outside world by reading quick feed and summaries WITHOUT having to leave your terminal; then TermFeed is for you. These are the main reasons I created TermFeed.


$ feed

  • browse latest feed from your favorite rss sources (links stored under the default category General).

$ feed <RSS-LINK>

  • browse latest feed from the single link <RSS-LINK> provided.
  • e.g. $ feed

$ feed -b

  • browse latest feeds by category of your library.

$ feed -t

  • list the topics stored in your library.

$ feed -t <CATEGORY>

  • list the URLs stored under <category> in your library.

$ feed -a <RSS-LINK>

  • add new link to your rss library.

$ feed -a <RSS-LINK> <CATEGORY>

  • add new link to your rss library under <category>.

$ feed -d <RSS-LINK>

  • delete a link from your rss library.

$ feed -D <category>

  • Remove entire category (with its URLs) from library.

$ feed -R

  • rebuild the library from

Features (what you can do?)

  • List feeds from different sources (stored in your library) with colorful text.
  • Preview a short summary of a selected feed.
  • Jump to (optionally) the source page of a feed in default browser.
  • Store new (or delete) RSS URLs in (from) your library under a specific topic or under the default tag General.


Default browsing


Browse by topic

browse topics

Update library (Add or delete links)

add delete

See the avaiable topics and RSS links in your library:

list topics

Help See $ feed -h for detailed usage.

TermFeed 0.0.8

    feed <rss-url>
    feed -b
    feed -a <rss-url> [<category>]
    feed -d <rss-url>
    feed -t [<category>]
    feed -D <category>
    feed -R
    feed (-h | --help)
    feed --version

                  List feeds from the default category 'General' of your library.
    <URL>         List feeds from the provided url source.
    -b            Browse feed by category avaialble in the database file.
    -a URL        Add new url <rss-url> to database under [<category>] (or 'General' otherwise).
    -d URL        Delete <rss-url> from the database file.
    -t            See the stored categories in your library, or list the URLs stored under <category> in your library.
    -D TOPIC      Remove entire cateogry (and its urls) from your library.
    -R            Rebuild the library from the
    -h --help     Show this screen.


  1. from PyPI repository:

    $ pip install TermFeed

  2. from the source distribution,

download and unpack the zipped folder, then:

$ cd TermFeed
$ python install


$ pip uninstall TermFeed

I use a data file (.termfeed.db) as a mini-database to maintain the RSS URLs. This file is created at the home directory (e.g. $HOME/.termfeed.db), delete it as well.

Remember, you may need to run these commands as an admin e.g. $ sudo ...



  • Tested on OS X and Linux.
  • Supports Python 2.7 and Python 3.4
  • The URLs in are complementary. They will be added to your library at $HOME/.termfeed.db when you run TermFeed ($ feed) for the first time. You may delete them all and have your own list instead.
  • Instant RSS Search is a nice search engine for searching RSS feeds.


  • Aziz Alto


No releases published


No packages published