{"id":26794869,"url":"https://github.com/sulami/feed2maildir","last_synced_at":"2025-04-22T18:07:46.806Z","repository":{"id":23746078,"uuid":"27120059","full_name":"sulami/feed2maildir","owner":"sulami","description":"📬 Read RSS/Atom feeds in your favourite, maildir-compatible email client.","archived":true,"fork":false,"pushed_at":"2020-12-16T15:35:49.000Z","size":77,"stargazers_count":15,"open_issues_count":1,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-22T18:07:39.489Z","etag":null,"topics":["atom","feedreader","maildir","python","rss"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/feed2maildir/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sulami.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-11-25T10:13:21.000Z","updated_at":"2025-02-05T10:22:11.000Z","dependencies_parsed_at":"2022-08-22T04:30:27.519Z","dependency_job_id":null,"html_url":"https://github.com/sulami/feed2maildir","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sulami%2Ffeed2maildir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sulami%2Ffeed2maildir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sulami%2Ffeed2maildir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sulami%2Ffeed2maildir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sulami","download_url":"https://codeload.github.com/sulami/feed2maildir/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250296175,"owners_count":21407037,"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":["atom","feedreader","maildir","python","rss"],"created_at":"2025-03-29T17:30:12.896Z","updated_at":"2025-04-22T18:07:46.732Z","avatar_url":"https://github.com/sulami.png","language":"Python","readme":"Feed2Maildir\n============\n\nRead RSS/Atom feeds in your favourite, maildir-compatible email client.\n\n.. image:: https://img.shields.io/pypi/v/feed2maildir.svg?style=flat-square\n    :target: https://pypi.python.org/pypi/feed2maildir\n\n.. image:: https://img.shields.io/pypi/dm/feed2maildir.svg?style=flat-square\n    :target: https://pypi.python.org/pypi/feed2maildir\n\nRequirements\n------------\n\n- Python 3.2+\n- ``feedparser``\n- ``python-dateutil``\n\nUsage\n-----\n\nJust run ``feed2maildir``, which should be placed in your $PATH by setup.py.\nYou will need a JSON configuration file at ``$HOME/.f2mrc`` that looks like\nthis:\n\n.. code-block:: json\n\n    {\n        \"db\": \"~/.f2mdb\",\n        \"maildir\": \"~/mail/feeds\",\n        \"feeds\": {\n            \"Coding Horror\": \"http://feeds.feedburner.com/codinghorror/\",\n            \"Commit Strip\": \"http://www.commitstrip.com/en/feed/\",\n            \"XKCD\": \"http://xkcd.com/rss.xml\",\n            \"What If?\": \"http://what-if.xkcd.com/feed.atom\",\n            \"Dilbert\": \"http://feed.dilbert.com/dilbert/daily_strip?format=xml\",\n            \"BSDNow\": \"http://feeds.feedburner.com/BsdNowOgg\"\n        }\n    }\n\nNote that the last element in a dict must not be followed by a comma, because\nPython's json.loads() says so.\n\nThere are a bunch of command-line arguments to overwrite the config file:\n\n::\n\n    optional arguments:\n        -h, --help  show this help message and exit\n        -c \u003cfile\u003e   override the config file location (~/.f2mrc)\n        -d \u003cfile\u003e   override the database file location (~/.f2mdb)\n        -m \u003cdir\u003e    override the maildir location (None)\n        -s          strip HTML from the feeds\n        -S \u003cprog\u003e   strip HTML from the feeds using an external program\n        -l          just write the links without the update\n\nTo check for updates regularly, just toss it into cron to run once every hour\nor so.\n\nStrip HTML\n----------\n\n``feed2maildir`` can strip the HTML tags from the feed using a built-in HTML\nstripper (option ``-s``) or using an external program (option ``-S \u003cprog\u003e``)\n\nIn this last case, the program must read the HTML from it standard input and\nreturn it stripped via the standard output.\n\nThe ``\u003cprog\u003e`` can be the name of a program or it can be a full shell command.\nIn that case don't forget to quote the full command.\n\nHere is an example of using ``pandoc`` to convert HTML to Markdown\n\n::\n\n    feed2maildir -S 'pandoc --from html --to markdown_strict'\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsulami%2Ffeed2maildir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsulami%2Ffeed2maildir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsulami%2Ffeed2maildir/lists"}