{"id":22564666,"url":"https://github.com/elliotkillick/rss2newsletter","last_synced_at":"2025-04-06T06:09:20.202Z","repository":{"id":247016744,"uuid":"816607816","full_name":"ElliotKillick/rss2newsletter","owner":"ElliotKillick","description":"Convert RSS/Atom feed to email newsletters","archived":false,"fork":false,"pushed_at":"2024-08-17T08:14:27.000Z","size":19,"stargazers_count":261,"open_issues_count":4,"forks_count":8,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-30T02:04:15.807Z","etag":null,"topics":["amazon-ses","atom-feed","automation","blog","cli","email-marketing","feed","listmonk-api","mailchimp","marketing","marketing-automation","minimal","minimalist","newsletter","rss","rss-feed","rss-to-email","rss2email","sendy","sendy-newsletter"],"latest_commit_sha":null,"homepage":"https://news.ycombinator.com/item?id=40898313","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ElliotKillick.png","metadata":{"files":{"readme":"README.md","changelog":"newsletter_template.html","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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-18T04:40:18.000Z","updated_at":"2025-03-23T22:46:31.000Z","dependencies_parsed_at":"2025-01-19T05:35:48.769Z","dependency_job_id":"d15ed1b9-5230-463b-8b4b-97d0ed9f5686","html_url":"https://github.com/ElliotKillick/rss2newsletter","commit_stats":null,"previous_names":["elliotkillick/rss2newsletter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElliotKillick%2Frss2newsletter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElliotKillick%2Frss2newsletter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElliotKillick%2Frss2newsletter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElliotKillick%2Frss2newsletter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ElliotKillick","download_url":"https://codeload.github.com/ElliotKillick/rss2newsletter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441052,"owners_count":20939239,"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":["amazon-ses","atom-feed","automation","blog","cli","email-marketing","feed","listmonk-api","mailchimp","marketing","marketing-automation","minimal","minimalist","newsletter","rss","rss-feed","rss-to-email","rss2email","sendy","sendy-newsletter"],"created_at":"2024-12-07T23:17:12.032Z","updated_at":"2025-04-06T06:09:20.183Z","avatar_url":"https://github.com/ElliotKillick.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/ElliotKillick/rss2newsletter\"\u003e\n        \u003cimg width=\"160\" height=\"160\" src=\"logo.svg\" alt=\"rss2newsletter Logo\" /\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003ch3 align=\"center\"\u003e\n    rss2newsletter\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cem\u003eFreely send newsletters \u003cstrong\u003e100x cheaper\u003c/strong\u003e via Amazon SES\u003c/em\u003e\n\u003c/p\u003e\n\n**rss2newsletter turns any RSS/Atom feed into a fully automated email newsletter with minimal setup.** The project aims to be a minimalist's 100% free and open source alternative to [Mailchimp's RSS-to-Email](https://mailchimp.com/features/rss-to-email/). Switching from Mailchimp could easily save you tens to hundreds or even thousands of dollars per month depending on your send volume. rss2newsletter intergrates with [listmonk](https://listmonk.app/) to send emails (which works with Amazon SES).\n\nrss2newsletter supports all the features you need to create appealing email newsletters including automated grabbing of a content image using your website's [OpenGraph metadata](https://ogp.me/#metadata). rss2newsletter + listmonk are also incredibly portable \u0026 lightweight, so there are no minimum system requirements for having them operate at full capacity 24/7 on any computer (unlike heavyweight proprietary solutions).\n\nCommon RSS feed sources you can turn into an email newsletter includes... your personal/team blog (virtually all blogging platforms produce RSS feeds by default), social media accounts/topics, news websites, and much more! Please only use rss2newsletter to deliver email that you would want in your inbox (e.g. notifying subscribers of new high effort content; no spam).\n\n## Get Started\n\n1. [Download listmonk](https://listmonk.app/#download)\n    - The listmonk server comes as a single binary that you can start in one command (set up with a provider like Amazon SES later)\n2. Get rss2newsletter: `pip3 install rss2newsletter`\n    - Ensure you already have Python installed\n    - If you prefer to use your system package manager then Git clone this repo and run the `install.sh` script\n3. Create rss2newsletter's [configuration file](https://raw.githubusercontent.com/ElliotKillick/rss2newsletter/main/rss2newsletter.conf) and design your email with the [newsletter template file](https://raw.githubusercontent.com/ElliotKillick/rss2newsletter/main/newsletter_template.html)\n4. Run `rss2newsletter` to start creating campaigns and sending out emails!\n\n## Usage\n\n```\n$ rss2newsletter --help\n\n               d88b                             8        w    w\n8d8b d88b d88b \" dP 8d8b. .d88b Yb  db  dP d88b 8 .d88b w8ww w8ww .d88b 8d8b\n8P   `Yb. `Yb.  dP  8P Y8 8.dP'  YbdPYbdP  `Yb. 8 8.dP'  8    8   8.dP' 8P\n8    Y88P Y88P d888 8   8 `Y88P   YP  YP   Y88P 8 `Y88P  Y8P  Y8P `Y88P 8\n... by @ElliotKillick\n\nusage: rss2newsletter.py [-h] [-c CONFIG]\n\nConvert an RSS feed to email newsletters\n\noptions:\n  -h, --help            show this help message and exit\n  -c CONFIG, --config CONFIG\n                        Program configuration file\n                        (default: rss2newsletter.conf)\n```\n\n## Support the Author\n\nIf you choose to host on a VPS, feel free to support the rss2newsletter author through one of my affiliate links (only one at the moment):\n\n[BuyVM](https://my.frantech.ca/aff.php?aff=7395\u0026site=slices)\n\nBuyVM has some of the most competitive prices on the market for small VPSs. Thank you!!\n\n## License\n\nAGPL License - Copyright (C) 2024 Elliot Killick \u003ccontact@elliotkillick.com\u003e\n\nWhy copyleft? I usually publish under a permissive open source license but there are too many proprietary email marketing solutions. Contact me if your company requires an alternative license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felliotkillick%2Frss2newsletter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felliotkillick%2Frss2newsletter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felliotkillick%2Frss2newsletter/lists"}