{"id":18272802,"url":"https://github.com/dibrinsofor/emailtracker","last_synced_at":"2025-04-09T03:28:04.066Z","repository":{"id":50358780,"uuid":"491635176","full_name":"dibrinsofor/emailtracker","owner":"dibrinsofor","description":"emailTracker","archived":false,"fork":false,"pushed_at":"2023-06-07T13:11:17.000Z","size":419,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-02-14T21:49:22.643Z","etag":null,"topics":["imap","privacy","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dibrinsofor.png","metadata":{"files":{"readme":"readme.md","changelog":null,"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":"2022-05-12T19:00:12.000Z","updated_at":"2022-08-29T11:06:03.000Z","dependencies_parsed_at":"2024-12-22T17:32:18.253Z","dependency_job_id":"4d0b455e-8e2b-4e8e-ac88-fe8667354c0d","html_url":"https://github.com/dibrinsofor/emailtracker","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dibrinsofor%2Femailtracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dibrinsofor%2Femailtracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dibrinsofor%2Femailtracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dibrinsofor%2Femailtracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dibrinsofor","download_url":"https://codeload.github.com/dibrinsofor/emailtracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247970944,"owners_count":21026230,"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":["imap","privacy","python"],"created_at":"2024-11-05T12:03:50.954Z","updated_at":"2025-04-09T03:28:04.049Z","avatar_url":"https://github.com/dibrinsofor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## emailtracker\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"460\" src=\"assets/logo%20for%20md.png\"\u003e\n\u003c/p\u003e\n\nemailtracker allows users detect whether or not mail in their inbox is being tracked. It offers support for emails (multi-part and plain text MIMEs) sent over the IMAP protocol. It allows you to determine:\n- What companies are tracking you.\n- How they do it? through blank pixels, clickable links, etc.\n- Whether or not your data is sent over secure protocols. \n- Infers what information they may be collecting.\n\n\u003c!-- how can we compare our approach to other email tracking detectors? --\u003e\n\n### installation\n- (recommended) activate a virtual env\n  - `python -m virtualenv venv`\n  - `venv\\scripts\\activate` \n- run build script `python build.py -s` to setup development environment\n\u003c!-- - install the project dependencies in `requirements.txt`\n  - `pip install -r requirements.txt\n- setup local registry of known adtracking companies:\n  - `python companies.py` --\u003e\n\u003c!-- - setup sqlite db\n  - run `flask shell` in your terminal. *it imports the app context for `db.engine commands`*\n  - run `db.create_all()` --\u003e\n\n### using\n- to package an executable binary:\n  - `python build.py -e` to build a one file executable or `pyinstaller --onefile app.spec`\n  \n- to run as a flask server:\n  - `python build.py -f (debug)` to setup environment and run the app, or\n  - `flask --debug run` \n\nYou can also setup the environment and spin up the server by running `python build.py` with no flags.\n\n#### Third-Party app passwords\nTo generate third-party app passwords, use these links: [Gmail](https://www.lifewire.com/get-a-password-to-access-gmail-by-pop-imap-2-1171882) and [Yahoo](https://www.esofttools.com/blog/how-to-generate-third-party-app-passwords-in-yahoo-account/).\n\n\n\u003c!-- #### Sample Output\n\n```txt\n===========Mail[b'1']===========\nSubject:     Last Chance: Save 20% on Ader404\nSender's Email Address: \u003cwaltervan@mail.jpg.com\u003e\nSender's Mail Server: mta.mail.acw.com. [136.222.180.666]\nLinks found:\nhttp://click.mail.kaptest.com/open.aspx?ffcb10-fe9313737c64007974-fdfd15707263067f77167472-fe901372766605757d-ff931375-fe2b127170610779761d70-ff061674756407\u0026d=70178\u0026bmt=0\nImages found:\nhttp://image.mail.kaptest.com/lib/fe901372766605757d/m/1/d6c8056a-36cf-4589-ad99-4d8beb56c491.png\nhttps://image.s4.exct.net/lib/fe911573736c007d7d/m/2/24b84e22-8d38-4d6c-98db-80812ca4de5f.png\nTracking Links found: \n\u003cimg src=\"http://click.mail.kaptest.com/open.aspx?ffcb10-fe9313737c64007974-fdfd15707263067f77167472-fe901372766605757d-ff931375-fe2b127170610779761d70-ff061674756407\u0026d=70178\u0026bmt=0\" width=\"1\" height=\"1\" alt=\"\"\u003e\n```\n### Contributing\n\nFrom suggestions, code refactors to tests, we accept small contributions. Things to note:\n- Style guide: [PEP8](https://peps.python.org/pep-0008/)\n- Use clear, informative commit messages\n --\u003e\n\n### License\nThis project is available under the MIT License. [Here](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdibrinsofor%2Femailtracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdibrinsofor%2Femailtracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdibrinsofor%2Femailtracker/lists"}