{"id":16393489,"url":"https://github.com/iamaziz/termfeed","last_synced_at":"2025-04-06T02:07:47.348Z","repository":{"id":57474233,"uuid":"42156081","full_name":"iamaziz/TermFeed","owner":"iamaziz","description":"A simple terminal feed reader.","archived":false,"fork":false,"pushed_at":"2023-06-12T21:56:57.000Z","size":357,"stargazers_count":254,"open_issues_count":10,"forks_count":18,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-05-12T06:02:43.486Z","etag":null,"topics":["feed","news-feed","reader","rss-reader","terminal"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamaziz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-09-09T04:31:10.000Z","updated_at":"2024-04-17T06:32:35.000Z","dependencies_parsed_at":"2024-01-13T04:22:37.552Z","dependency_job_id":null,"html_url":"https://github.com/iamaziz/TermFeed","commit_stats":{"total_commits":34,"total_committers":2,"mean_commits":17.0,"dds":0.02941176470588236,"last_synced_commit":"03f897d72c24e74c2c40e60c8dd26bcf2b123716"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaziz%2FTermFeed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaziz%2FTermFeed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaziz%2FTermFeed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaziz%2FTermFeed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamaziz","download_url":"https://codeload.github.com/iamaziz/TermFeed/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423513,"owners_count":20936626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["feed","news-feed","reader","rss-reader","terminal"],"created_at":"2024-10-11T04:53:23.325Z","updated_at":"2025-04-06T02:07:47.327Z","avatar_url":"https://github.com/iamaziz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"TermFeed\n====\n\n[![PyPI version](https://badge.fury.io/py/termfeed.svg)](http://badge.fury.io/py/termfeed)\n\n**Term**inal **Feed** is a *minimal* feed **reader** for the terminal (without curses).\n\nTo read, preview, open, store, or delete your favorite RSS feeds from the command line.\n\n#### Why?\n\nIf 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.\n\n\n\n### Usage\n\n`$ feed`\n\n- browse latest feed from your favorite rss sources (links stored under the default category `General`).\n\n`$ feed \u003cRSS-LINK\u003e`\n\n- browse latest feed from the single link `\u003cRSS-LINK\u003e` provided.\n- e.g. `$ feed https://news.ycombinator.com/rss`\n\n`$ feed -b`\n\n- browse latest feeds by category of your library.\n\n`$ feed -t`\n\n- list the topics stored in your library.\n\n`$ feed -t \u003cCATEGORY\u003e`\n\n- list the URLs stored under `\u003ccategory\u003e` in your library.\n\n`$ feed -a \u003cRSS-LINK\u003e`\n\n- add new link to your rss library.\n\n`$ feed -a \u003cRSS-LINK\u003e \u003cCATEGORY\u003e`\n\n- add new link to your rss library under `\u003ccategory\u003e`.\n\n`$ feed -d \u003cRSS-LINK\u003e`\n\n- delete a link from your rss library.\n\n`$ feed -D \u003ccategory\u003e`\n- Remove entire category (with its URLs) from library.\n\n`$ feed -R`\n\n- rebuild the library from `urls.py`\n\n\n### Features (what you can do?)\n\n- List feeds from different sources (stored in your library) with colorful text.\n- Preview a short summary of a selected feed.\n- Jump to (optionally) the source page of a feed in default browser.\n- Store new (or delete) RSS URLs in (from) your library under a specific topic or under the default tag `General`.\n\n\n### Examples\n\n\u003c!-- see: TermFeed gifs repo: http://imgur.com/a/EBHho\n--\u003e\n\nDefault browsing\n\n![default](http://i.imgur.com/CXFFIaF.gif?1)\n\nBrowse by topic\n\n![browse topics](http://i.imgur.com/J09EFVv.gif?1)\n\nUpdate library (Add or delete links)\n\n![add delete](http://i.imgur.com/wcHdK4l.gif?1)\n\n\nSee the avaiable topics and RSS links in your library:\n\n![list topics](http://i.imgur.com/98DM6US.gif?1)\n\nHelp\nSee `$ feed -h` for detailed usage.\n\n```\nTermFeed 0.0.8\n\nUsage:\n    feed\n    feed \u003crss-url\u003e\n    feed -b\n    feed -a \u003crss-url\u003e [\u003ccategory\u003e]\n    feed -d \u003crss-url\u003e\n    feed -t [\u003ccategory\u003e]\n    feed -D \u003ccategory\u003e\n    feed -R\n    feed (-h | --help)\n    feed --version\n\nOptions:\n                  List feeds from the default category 'General' of your library.\n    \u003cURL\u003e         List feeds from the provided url source.\n    -b            Browse feed by category avaialble in the database file.\n    -a URL        Add new url \u003crss-url\u003e to database under [\u003ccategory\u003e] (or 'General' otherwise).\n    -d URL        Delete \u003crss-url\u003e from the database file.\n    -t            See the stored categories in your library, or list the URLs stored under \u003ccategory\u003e in your library.\n    -D TOPIC      Remove entire cateogry (and its urls) from your library.\n    -R            Rebuild the library from the url.py\n    -h --help     Show this screen.\n```\n\n\n### Installation\n\n1) from `PyPI` repository:\n\n\t$ pip install TermFeed\n\n\n2) from the source distribution,\n\ndownload and unpack the [zipped folder](https://github.com/iamaziz/TermFeed/archive/master.zip), then:\n\n\t$ cd TermFeed\n\t$ python setup.py install\n\n### Uninstall\n\n\n\t$ pip uninstall TermFeed\n\nI use a data file (`.termfeed.db`) as a mini-database to maintain the RSS URLs.\nThis file is created at the home directory (e.g. `$HOME/.termfeed.db`), delete it as well.\n\n\n\u003e Remember, you may need to run these commands as an admin e.g.\n\u003e \t`$ sudo ...`\n\n\n#### Dependencies\n\n- [feedparser](https://pypi.python.org/pypi/feedparser)\n\n\n#### Miscellaneous\n\n- Tested on OS X and Linux.\n- Supports Python 2.7 and Python 3.4\n- The URLs in `urls.py` 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.\n- [Instant RSS Search](http://ctrlq.org/rss) is a nice search engine for searching RSS feeds.\n\n\n### Author\n\n- Aziz Alto\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamaziz%2Ftermfeed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamaziz%2Ftermfeed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamaziz%2Ftermfeed/lists"}