{"id":15775520,"url":"https://github.com/felipelaptrin/email-forwarder","last_synced_at":"2026-01-05T13:08:08.755Z","repository":{"id":238201633,"uuid":"796082829","full_name":"felipelaptrin/email-forwarder","owner":"felipelaptrin","description":"Forwards only the subject of the emails to secure your phone from robbers","archived":false,"fork":false,"pushed_at":"2024-05-23T15:32:53.000Z","size":48,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-11T17:04:59.631Z","etag":null,"topics":["blog","cdk","devbox","lambda","python","typescript"],"latest_commit_sha":null,"homepage":"https://felipetrindade.com/email-forwarder","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/felipelaptrin.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}},"created_at":"2024-05-04T22:06:02.000Z","updated_at":"2024-05-23T15:32:56.000Z","dependencies_parsed_at":"2024-10-25T21:16:23.855Z","dependency_job_id":"75483a65-8072-4485-8367-d76884386c97","html_url":"https://github.com/felipelaptrin/email-forwarder","commit_stats":{"total_commits":11,"total_committers":2,"mean_commits":5.5,"dds":0.09090909090909094,"last_synced_commit":"715bfe8df38345cb51ae035562b2d61718028fd0"},"previous_names":["felipelaptrin/email-forwarder"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipelaptrin%2Femail-forwarder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipelaptrin%2Femail-forwarder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipelaptrin%2Femail-forwarder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipelaptrin%2Femail-forwarder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipelaptrin","download_url":"https://codeload.github.com/felipelaptrin/email-forwarder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245168810,"owners_count":20571799,"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":["blog","cdk","devbox","lambda","python","typescript"],"created_at":"2024-10-04T17:01:16.411Z","updated_at":"2026-01-05T13:08:03.734Z","avatar_url":"https://github.com/felipelaptrin.png","language":"Python","readme":"# email-forwarder\n\nThe entire documentation about this project is presented in my [blog post](https://felipetrindade.com/email-forwarder).\n\n\n## Pricing\n\nAWS offers a generous free tier for the services we use:\n\n- `Parameter Store`: Standard parameters are free. The interaction (retrieve/update value) with the parameter costs `$0.05` per 10,000 interactions.\n- `EventBridge Rule`: Free for our use case.\n- `SNS`: 1,000 notifications are free, after that $2 per 100,000 notifications.\n- `Lambda`: This varies based on the memory and execution time of the Lambda. Using a Lambda of 512MB and 5s for each execution and running every 1 minute we will use around `110,000GB-s/month`. The free tier is 1 million invocations per month and 400,000Gb-s of compute time. So for us, this will be free.\n\nSo this is very likely to be free for you!\n\n## Deployment\n\nTo make it more user-friendly I will do a step-by-step guide to help you setup all of this. Follow this in order!\n\n### Gmail settings\n\nThe first thing we need to do is to access your [Gmail settings](https://mail.google.com/mail/u/0/#settings/general) and make sure the `IMAP` is enabled (check the `Forwarding and POP/IMAP` tab).\n\nAfter that let's create a new App Password for us to use with the IMAP.\n\n1) Access [Google Settings](https://myaccount.google.com/?hl=en)\n\n![Google Settings](https://github.com/felipelaptrin/felipetrindade.com/blob/main/frontend/content/blog/email-forwarder/assets/gmail/google-settings.png)\n\n2) Search for `App Passwords`\n\n![Google Setting App Passwords](https://github.com/felipelaptrin/felipetrindade.com/blob/main/frontend/content/blog/email-forwarder/assets/gmail/google-app-passwords.png)\n\n3) Create a new app password and copy the password value after creation\n\n![Creating a new App Password](https://github.com/felipelaptrin/felipetrindade.com/blob/main/frontend/content/blog/email-forwarder/assets/gmail/google-app-passwords-creation.png)\n\nMake sure to do all these steps in the email accounts you want to secure, in my case I have two (so I did this for both accounts).\n\n### Infrastructure deployment\n\nTo make the development live easier I set up [DevBox](https://www.jetify.com/devbox/docs/) in the project. So you only need to have DevBox installed and run `devbox shell` to install all the dependencies of the project (NodeJS, Yarn...).\n\n1) Install the dependencies\n\n```sh\ndevbox shell\n```\n\n2) Move to the `infrastructure` folder\n\n```sh\ncd infrastructure\n```\n\n3) Install NodeJS dependencies\n\n```sh\nyarn\n```\n\n4) Modify the `config.ts` file accordingly\n\n5) Deploy the infrastructure\n\n```sh\nyarn cdk deploy\n```\n\nMake you have AWS credentials setup in place and that your account-region is already [CDK bootstraped](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html).\n\n6) Check the receiver email and accept the subscribe email from Amazon SNS\n\n![Email inbox - accepting AWS SNS topic](https://github.com/felipelaptrin/felipetrindade.com/blob/main/frontend/content/blog/email-forwarder/assets/gmail/inbox.png)\n\n6) Go to the AWS console and update the parameter(s) that contain your password (e.g. `/email/gmail.com/\u003cYOUR_EMAIL\u003e/password`) to used the app password you copied.\n\n## Final result\n\nFinally! Now we are receiving our forwarded emails as expected!\n\n![Screenshot inbox from receiver email](https://github.com/felipelaptrin/felipetrindade.com/blob/main/frontend/content/blog/email-forwarder/assets/gmail/inbox-receiver.png)\n\n\n![Screenshot email from receiver email](https://github.com/felipelaptrin/felipetrindade.com/blob/main/frontend/content/blog/email-forwarder/assets/gmail/email.png)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipelaptrin%2Femail-forwarder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipelaptrin%2Femail-forwarder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipelaptrin%2Femail-forwarder/lists"}