Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ElliotKillick/rss2newsletter
Convert RSS/Atom feed to email newsletters
https://github.com/ElliotKillick/rss2newsletter
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
Last synced: 3 months ago
JSON representation
Convert RSS/Atom feed to email newsletters
- Host: GitHub
- URL: https://github.com/ElliotKillick/rss2newsletter
- Owner: ElliotKillick
- License: agpl-3.0
- Created: 2024-06-18T04:40:18.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-07-16T07:35:38.000Z (4 months ago)
- Last Synced: 2024-07-19T10:58:29.023Z (4 months ago)
- 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
- Language: Python
- Homepage: https://news.ycombinator.com/item?id=40898313
- Size: 18.6 KB
- Stars: 231
- Watchers: 5
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: newsletter_template.html
- License: LICENSE
Awesome Lists containing this project
- awesome-opensource-email - RSS2Newsletter - Convert RSS/Atom feed to email newsletters - `GNU Affero General Public License v3.0`, `Python` (Email Platform / Newsletter Platform)
README
rss2newsletter
Freely send newsletters 100x cheaper via Amazon SES
**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).
rss2newsletter 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 & lightweight, so there are no minimum system requirements for having them operate at full capacity 24/7 on any computer (unlike heavyweight proprietary solutions).
Common 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).
## Get Started
1. [Download listmonk](https://listmonk.app/#download)
- The listmonk server comes as a single binary that you can start in one command (set up with a provider like Amazon SES later)
2. Get rss2newsletter: `pip3 install rss2newsletter`
- Ensure you already have Python installed
- If you prefer to use your system package manager then Git clone this repo and run the `install.sh` script
3. 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)
4. Run `rss2newsletter` to start creating campaigns and sending out emails!
## Usage
```
$ rss2newsletter --help
d88b 8 w w
8d8b d88b d88b " dP 8d8b. .d88b Yb db dP d88b 8 .d88b w8ww w8ww .d88b 8d8b
8P `Yb. `Yb. dP 8P Y8 8.dP' YbdPYbdP `Yb. 8 8.dP' 8 8 8.dP' 8P
8 Y88P Y88P d888 8 8 `Y88P YP YP Y88P 8 `Y88P Y8P Y8P `Y88P 8
... by @ElliotKillick
usage: rss2newsletter.py [-h] [-c CONFIG]
Convert an RSS feed to email newsletters
options:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Program configuration file
(default: rss2newsletter.conf)
```
## Support the Author
If 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):
[BuyVM](https://my.frantech.ca/aff.php?aff=7395&site=slices)
BuyVM has some of the most competitive prices on the market for small VPSs. Thank you!!
## License
AGPL License - Copyright (C) 2024 Elliot Killick
Why 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.