{"id":27122219,"url":"https://github.com/vmapps/feed2mail","last_synced_at":"2026-07-17T03:06:31.076Z","repository":{"id":53661309,"uuid":"186693623","full_name":"vmapps/feed2mail","owner":"vmapps","description":"News feeds sent to your mailbox","archived":false,"fork":false,"pushed_at":"2024-09-20T20:39:08.000Z","size":667,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-31T08:15:00.686Z","etag":null,"topics":["email","feedparser","jinja2","news","smtplib","templates"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vmapps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-05-14T20:15:40.000Z","updated_at":"2024-09-20T20:39:12.000Z","dependencies_parsed_at":"2025-06-09T12:05:23.955Z","dependency_job_id":"dd456fce-9c0a-4ff0-8aa5-4aa4e69e70a7","html_url":"https://github.com/vmapps/feed2mail","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/vmapps/feed2mail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmapps%2Ffeed2mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmapps%2Ffeed2mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmapps%2Ffeed2mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmapps%2Ffeed2mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vmapps","download_url":"https://codeload.github.com/vmapps/feed2mail/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmapps%2Ffeed2mail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35565095,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-17T02:00:06.162Z","response_time":116,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["email","feedparser","jinja2","news","smtplib","templates"],"created_at":"2025-04-07T11:26:19.434Z","updated_at":"2026-07-17T03:06:31.047Z","avatar_url":"https://github.com/vmapps.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# feed2mail\nNews feeds sent to your mailbox\n\n## Purpose \nPurpose of this very simple tool is to :\n- help retrieving news from different feeds (RSS, ATOM, XML, ...)\n- compile one of those that match a pediod (e.g. 'yesterday')\n- send articles as HTML document to some email recipients\n\n## Requirements\nFollowing python modules are required :\n- [email](https://docs.python.org/3/library/email.html)\n- [feedparser](https://pythonhosted.org/feedparser/)\n- [jinja2](http://jinja.pocoo.org/)\n- [smtplib](https://docs.python.org/3/library/smtplib.html)\n\nModules could be installed using following commands:\n```\n$ pip install -r requirements.txt\n```\n## Configuration\nSettings have to be defined using JSON config file :\n```\n# enable/disable debug mode\n\"debug\": [true|false]\n\n# SMTP settings\n\"smtp.host\": \"\u003cyour_ISP_SNMTP_server\u003e\"\n\"smtp.port\": 465\n\"smtp.ssl\": [true|false]\n\"smtp.user\": \"\u003cyour_user\u003e\"\n\"smtp.pass\": \"\u003cyour_password\u003e\"\n\n# feeds sources and period of posts to take into consideration\n\"feeds.sources\": [\n    'http://feeds.arstechnica.com/arstechnica/security/',\n    'https://nakedsecurity.sophos.com/feed/',\n    'https://www.theregister.co.uk/security/headlines.atom'\n]\n\"feeds.period\": \"[all|yesterday|today]\"\n\n# email settings\n\"email.sender\": \"\u003csender_email_address\u003e\"\n\"email.recipient\": \"\u003crecipient_email_address\u003e\"\n\"email.title\": \"\u003cpretty_nice_title\u003e\"\n```\nDo not forget to rename template file as `config.json`\n```\nmv config-template.json config.json\n```\n## Usage\n```\nusage: feed2mail.py [-h] [-a] [-d] [-c \u003cfilename\u003e] [-o \u003cfilename\u003e] [-t \u003cfilename\u003e]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -a, --attachment      add HTML content as attachment\n  -d, --debug           force debug mode (not used yet)\n  -c \u003cfilename\u003e, --config \u003cfilename\u003e\n                        config file name (defaut: config.json)\n  -t \u003cfilename\u003e, --template \u003cfilename\u003e\n                        template file name (defaut: templates/feed2mail.html)\n  -o \u003cfilename\u003e, --output \u003cfilename\u003e\n                        output file name\n```\n## Outputs\n```\n$ feed2mail.py\n[INFO] message successfully sent to *****@*****.***\n\n$ feed2mail.py -c feed2mail.json -t templates/feed2mail-outlook.html -o /tmp/output.html\n[INFO] message successfully sent to *****@*****.***\n```\nOnce executed, the program will generate :\n- HTML code in email body\n- HTML file attached to the email\n- HTML code to \u003cfilename\u003e if output option is used\n- success/error messages to stderr\n    \n## Sample\n![newsletter](samples/feed2mail.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmapps%2Ffeed2mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvmapps%2Ffeed2mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmapps%2Ffeed2mail/lists"}