{"id":16064427,"url":"https://github.com/antoniosbarotsis/rss2email","last_synced_at":"2025-04-09T10:06:08.027Z","repository":{"id":60576551,"uuid":"531587212","full_name":"AntoniosBarotsis/Rss2Email","owner":"AntoniosBarotsis","description":"An RSS feed aggregator that notifies you of new posts via email.","archived":false,"fork":false,"pushed_at":"2025-03-25T16:20:38.000Z","size":465,"stargazers_count":25,"open_issues_count":3,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T09:07:11.239Z","etag":null,"topics":["atom","aws-lambda","blog","docker","email","feed","hacktoberfest","rss","rss-aggregator","rust","sendgrid"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AntoniosBarotsis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2022-09-01T15:52:47.000Z","updated_at":"2025-03-25T16:20:43.000Z","dependencies_parsed_at":"2024-04-05T17:39:52.320Z","dependency_job_id":"ef21ec01-a18b-4718-b3e2-764fa9d13730","html_url":"https://github.com/AntoniosBarotsis/Rss2Email","commit_stats":{"total_commits":203,"total_committers":8,"mean_commits":25.375,"dds":0.1921182266009852,"last_synced_commit":"ea0bef9f80b7ebf58a4f4020545aa9c3d8829bed"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntoniosBarotsis%2FRss2Email","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntoniosBarotsis%2FRss2Email/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntoniosBarotsis%2FRss2Email/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntoniosBarotsis%2FRss2Email/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AntoniosBarotsis","download_url":"https://codeload.github.com/AntoniosBarotsis/Rss2Email/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248018060,"owners_count":21034048,"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","aws-lambda","blog","docker","email","feed","hacktoberfest","rss","rss-aggregator","rust","sendgrid"],"created_at":"2024-10-09T05:07:41.699Z","updated_at":"2025-04-09T10:06:08.006Z","avatar_url":"https://github.com/AntoniosBarotsis.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rss2Email\n\n[![Build \u0026 Tests](https://github.com/AntoniosBarotsis/Rss2Email/actions/workflows/ci.yml/badge.svg)](https://github.com/AntoniosBarotsis/Rss2Email/actions/workflows/ci.yml)\n[![Crates.io](https://img.shields.io/crates/v/rss2email)](https://crates.io/crates/rss2email)\n[![docs.rs](https://img.shields.io/docsrs/rss2email)](https://docs.rs/rss2email/)\n![Minimum Supported Rust Version](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/AntoniosBarotsis/87883f70db3cf998342786f65fe1b9df/raw/rss2email_msrv.json)\n[![dependency status](https://deps.rs/repo/github/AntoniosBarotsis/Rss2Email/status.svg?path=.)](https://deps.rs/repo/github/AntoniosBarotsis/Rss2Email?path=.)\n[![Docker Images](https://img.shields.io/badge/Docker-Images-0092e6?logo=docker)](https://hub.docker.com/u/antoniosbarotsis?page=1\u0026search=rss2email)\n[![Actively Maintained](https://img.shields.io/badge/Maintenance%20Level-Actively%20Maintained-green.svg)](https://gist.github.com/cheerfulstoic/d107229326a01ff0f333a1d3476e068d)\n\u003c!-- [![GitHub milestone](https://img.shields.io/github/milestones/progress/AntoniosBarotsis/rss2email/1?color=32ca55\u0026label=Progress%20towards%20v1.0\u0026labelColor=353d46)](https://github.com/users/AntoniosBarotsis/projects/2/views/1?query=is%3Aopen+sort%3Aupdated-desc\u0026filterQuery=milestone%3A%22v1.0%22) --\u003e\n\nA small program capable of aggregating content from multiple RSS/Atom feeds and mailing them to you\nin a practical summary email. Keep track of your favorite blogs that don't feature an update\nnewsletter or similar service.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/res.jpg\" alt=\"Example\"\u003e\n\u003c/p\u003e\n\n## Dependencies\n\nYou'll need [Rust](https://rust-lang.org/) or [Docker](https://www.docker.com/) installed to\ncompile this software.\n\n## Installation\n\nEach release automatically publishes Docker images for\n[x86](https://hub.docker.com/repository/docker/antoniosbarotsis/rss2email-x86) and\n[arm](https://hub.docker.com/repository/docker/antoniosbarotsis/rss2email-arm) on DockerHub.\nNote that these can only run on AWS Lambda. If you want to run them elsewhere through Docker, read\n[here](https://github.com/AntoniosBarotsis/Rss2Email/wiki/4.-More-on-Docker).\n\nAlternatively, you can build this from source. Clone this repository and run:\n\n```bash\ncargo build --release\n```\n\nCheck out the\n[build from source](https://github.com/AntoniosBarotsis/Rss2Email/wiki/1.-Home#building-from-source)\nsection of the wiki for more information.\n\n## Configuration\n\n**Rss2email** requires some environment variables to work. These can be provided either in your\nshell or as entries in a `.env` file.\n\n- `EMAIL_ADDRESS`: the mail address you will use to send the emails\n- `RECIPIENT_ADDRESSES`: comma delimited list of recipient email addresses\n- `SUBJECT`: the email subject (could be `rss2email`). Including `$POST_COUNT` in your subject will\n  have it replaced with the number of posts fetched. For example `SUBJECT=rss2email - $POST_COUNT new posts`\n- `DAYS`: this value indicates up to how many days in the past we go to search for entries  \n- `FEEDS`: a list of semicolon-separated feed URLs.  \n  _eg:_ `\"https://blog.rust-lang.org/feed.xml;https://www.linux.org/articles/index.rss\"`\n- `EMAIL` (optional, defaults to `SendGrid`):  Which provider to use to send the email.  \n  For the supported providers, you can check the \n  [docs](https://docs.rs/rss2email/latest/rss2email_lib/email/email_provider/enum.EmailProviders.html).\n- `API_KEY` (optional): Your email provider's authentication key.\n- `SKIP_IF_NO_NEW_POSTS` (optional): Whether an email should be sent if the number of posts fetched is 0.\n\nMore details are available in the \n[Running the code](https://github.com/AntoniosBarotsis/Rss2Email/wiki/3.-Running-the-Code) wiki \nsection.\n\n## Usage\n\nRunning the code in debug mode won't send any emails and will instead output the generated HTML in\nthe console.\n\n```bash\ncargo run\n```\n\nIt is recommended to try this out first and make sure that all your feeds and config variables are\ncorrectly set up.\n\nRunning the project in release mode will send the emails\n\n```bash\n./target/release/Rss2email\n# or\ncargo run --release\n```\n\n\u003c!-- ## Known Issues --\u003e\n\n## Contributing\n\nThanks for considering contributing!\n\nRead [this](./CONTRIBUTING.md).\n\n## Thanks to all Contributors!\n\n\u003ca href=\"https://github.com/AntoniosBarotsis/Rss2Email/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=AntoniosBarotsis/Rss2Email\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantoniosbarotsis%2Frss2email","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantoniosbarotsis%2Frss2email","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantoniosbarotsis%2Frss2email/lists"}