{"id":13434349,"url":"https://github.com/apparition47/MailTrackerBlocker","last_synced_at":"2025-03-17T14:31:13.944Z","repository":{"id":37809331,"uuid":"277057483","full_name":"apparition47/MailTrackerBlocker","owner":"apparition47","description":"Email tracker, read receipt and spy pixel blocker plugin for macOS Mail (10.11-13.x)","archived":false,"fork":false,"pushed_at":"2024-10-26T14:14:27.000Z","size":2342,"stargazers_count":1112,"open_issues_count":9,"forks_count":22,"subscribers_count":24,"default_branch":"main","last_synced_at":"2024-10-29T15:38:41.659Z","etag":null,"topics":["ad-block","apple","apple-mail","email","email-parsing","macos","mail-filter","objective-c","privacy","privacy-protection","tracking"],"latest_commit_sha":null,"homepage":"https://apparition47.github.io/MailTrackerBlocker/","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apparition47.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"apparition47","ko_fi":"apparition47","custom":["https://paypal.me/iOSguy","https://btc.com/3H5NJhYusExQfKusWggJxMdkfAg5VmPhYd","https://etherscan.io/address/0x1dee3868D0f77f2dB5F7465D89Ce51295106F223"]}},"created_at":"2020-07-04T07:01:45.000Z","updated_at":"2024-10-26T14:14:20.000Z","dependencies_parsed_at":"2024-03-12T12:51:30.117Z","dependency_job_id":"a0ecd623-f97e-4062-a6b0-bda8fc731396","html_url":"https://github.com/apparition47/MailTrackerBlocker","commit_stats":null,"previous_names":[],"tags_count":91,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apparition47%2FMailTrackerBlocker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apparition47%2FMailTrackerBlocker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apparition47%2FMailTrackerBlocker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apparition47%2FMailTrackerBlocker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apparition47","download_url":"https://codeload.github.com/apparition47/MailTrackerBlocker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243858035,"owners_count":20359261,"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":["ad-block","apple","apple-mail","email","email-parsing","macos","mail-filter","objective-c","privacy","privacy-protection","tracking"],"created_at":"2024-07-31T02:01:53.985Z","updated_at":"2025-03-17T14:31:13.937Z","avatar_url":"https://github.com/apparition47.png","language":"Objective-C","readme":"\u003cp align=\"center\"\u003e\u003cimg width=\"635\" src=\"https://user-images.githubusercontent.com/3298414/121038136-00d2f780-c7eb-11eb-8e1a-d7d1fafc2e15.jpg\"\u003e\u003c/p\u003e\n\n**MailTrackerBlocker** is a email tracker blocking plugin (mailbundle) for macOS Mail. [Email marketers and other interests often embed these trackers in HTML emails so they can track how often, when and where you open your emails.](https://notospypixels.com/) Find out who is tracking you and block spy pixels without needing to disable \"load remote content in messages\" so that you can browse your inbox privately with images displayed once again.\n\n\n## Requirements\n\n- macOS El Capitan 10.11 - Ventura 13 ([why not newer versions?](https://www.macrumors.com/2023/06/14/macos-sonoma-drops-legacy-mail-app-plug-ins/))\n- Apple Mail\n\n\n## Setup\n\n### Installation\n\nYou can install `MailTrackerBlocker.pkg` directly from the [releases page](https://github.com/apparition47/MailTrackerBlocker/releases) or via [Homebrew Cask](https://brew.sh):\n\n```bash\n$ brew install mailtrackerblocker\n```\n\n### Usage\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003emacOS 12, 13\u003c/b\u003e\u003c/summary\u003e\n\u003cbr\u003e\n1. Tap on the \u003cstrong\u003eⓧ\u003c/strong\u003e button to find out what was blocked.\n\u003cbr\u003e\n2. [Optional] Images are safe for viewing so to re-enable: from the Mail menu bar, open Settings \u003e Privacy \u003e disable \u003ca href=\"https://techviral.net/wp-content/uploads/2021/11/Mail-Privacy-Protection.jpg\"\u003e\"Block All Remote Content\"\u003c/a\u003e.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003emacOS 10.11, 10.12, 10.13, 11\u003c/b\u003e\u003c/summary\u003e\n\u003cbr\u003e\n1. Tap on the \u003cstrong\u003eⓧ\u003c/strong\u003e button to find out what was blocked.\n\u003cbr\u003e\n2. [Optional] Images are safe for viewing so to re-enable: from the Mail menu bar, open Settings \u003e Viewing \u003e re-enable \u003ca href=\"https://www.imore.com/sites/imore.com/files/styles/xlarge/public/field/image/2019/07/mac-load-remote.jpg\"\u003e\"Load remote content in messages\"\u003c/a\u003e.\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003emacOS 10.14, 10.15\u003c/b\u003e\u003c/summary\u003e\n\u003cbr\u003e\n1. Open Mail, goto `Preferences \u003e General \u003e Manage Plug-ins... \u003e check \"MailTrackerBlocker.mailbundle\" \u003e Apply and Restart Mail`. Note that you'll need to do this again for each update.\n\u003cbr\u003e\n2. Tap on the \u003cstrong\u003eⓧ\u003c/strong\u003e button to find out what was blocked.\n\u003cbr\u003e\n3. [Optional] Images are safe for viewing so to re-enable: from the Mail menu bar, open Settings \u003e Viewing \u003e re-enable \u003ca href=\"https://www.imore.com/sites/imore.com/files/styles/xlarge/public/field/image/2019/07/mac-load-remote.jpg\"\u003e\"Load remote content in messages\"\u003c/a\u003e.\n\u003c/details\u003e\n\n\n### To uninstall\n\nIf you installed with Homebrew:\n\n```bash\n$ brew uninstall mailtrackerblocker\n```\n\nIf you installed the `pkg` manually:\n\n```bash\nosascript -e \"quit app \\\"Mail\\\"\"\n# plugin files\nsudo rm -r /Library/Mail/Bundles/MailTrackerBlocker.mailbundle\nsudo rm -r /Library/Application\\ Support/com.onefatgiraffe/mailtrackerblocker\nsudo pkgutil --forget com.onefatgiraffe.mailtrackerblocker\n# user-generated settings\nrm -r ~/Library/Containers/com.apple.mail/Data/Library/Application\\ Support/com.onefatgiraffe.mailtrackerblocker\ndefaults delete com.apple.mail _mtb_IsAutoUpdateCheckAllowed\ndefaults delete com.apple.mail _mtb_IsFirstStartup\ndefaults delete com.apple.mail _mtb_LastUpdateCheckDate\n```\n\n## FAQ\n\n### Does this work with Mail Privacy Protection?\n\nYes, in some network environments (e.g. VPN) where Mail Privacy Protection doesn't work, MailTrackerBlocker will still block and identify trackers if you choose to \"Load Remote Content\".\n\nNote: [Mail Privacy Protection's proxy will still fetch the tracker image, triggering the tracker after an unknown period of time](https://www.mailbutler.io/blog/news/why-apples-mail-privacy-protection-does-not-break-mailbutlers-tracking-feature/). In the period of time before this happens, if you open your email without MailTrackerBlocker, the proxy will fetch the tracking image and trigger the tracker at that moment still letting the tracker know your exact opening time.\n\n### Why am I getting a \"Incompatible Plug-ins Disabled\" message after enabling?\n\nTypically caused by a Mac migration or a restoration from backup. [Delete Mail's private plugin-ins dir (or DataVaults)](https://c-command.com/spamsieve/help/resetting-mail-s-privat) to fix this issue. This directory will safely and automatically be regenerated afterwards.\n\n### Why is my Mail so slow?\n\nThis issue isn't related to MailTrackerBlocker but such problems can be resolved by doing a complete [Mailbox Rebuild](https://c-command.com/spamsieve/help/how-can-i-rebuild-apple) to force Mail to regenerate its indexes.\n\n\n## Building from source\n\nBuilding will automatically install a copy into your `/Library/Mail/Bundles/` dir so if you have a current installation from the public pkg installer, you'll need to remove it due to permissions: `$ rm -rf /Library/Bundles/MailTrackerBlocker.mailbundle`.\n\n```bash\ngit clone https://github.com/apparition47/MailTrackerBlocker.git --recursive\ncd MailTrackerBlocker\n```\n\n#### A. Make\n\nTo sign with your identity, edit the `Makefile` to specify your own `Developer ID Application` (used to sign the plugin binary [for macOS 11 and up]) and `Developer ID Installer` (used to sign the pkg) certificates. You can also comment out the top lines to disable signing.\n\nTo build binary, pkg and sign (if configured):\n\n```bash\nmake all\nopen build/Release\n```\n\n#### B. Xcode\n\n1. Give Xcode `Full Disk Access` from `System Preferences \u003e Security \u0026 Privacy \u003e Privacy \u003e Full Disk Access` and add Xcode.\n     * Required because the mailbundle needs to be installed into `/Library/Mail/Bundles`.\n2. Open the Xcode project.\n3. Change the Signing settings in `Signing \u0026 Capabilities` (macOS 11 and up: you'll need to use your own `Developer ID Application` certificate; below macOS 11: set it to none/don't sign) then hit build.\n     * mac OS 11 and up: allow `Finder` access to allow Xcode to copy unsigned directly into sandboxed env\n\n\n## [Credits](https://github.com/apparition47/MailTrackerBlocker/blob/master/Resources/ACKNOWLEDGEMENTS)\n\n* MailTrackerBlocker project sponsors, donators and contributors\n* **[@dhh](https://github.com/dhh)** for the [spy pixel tracker block list used in HEY](https://gist.github.com/dhh/360f4dc7ddbce786f8e82b97cdad9d20)\n* **[@leggett](https://github.com/leggett)** for his [Simplify Gmail blocklist](https://github.com/leggett/simplify-trackers)\n* **[@raybrownco](https://github.com/raybrownco)** for the original UI design and icon\n* **[GPGTools Team](https://gpgtools.org/)** for their open source GPGMail plugin from which MailTrackerBlocker is based on\n* **[SpamSieve](https://c-command.com/spamsieve/)** for their Mail knowledgebase and troubleshooting manuals\n\n\n## [License](https://github.com/apparition47/MailTrackerBlocker/blob/master/LICENSE)\n\nBSD-3.\n","funding_links":["https://github.com/sponsors/apparition47","https://ko-fi.com/apparition47","https://paypal.me/iOSguy","https://btc.com/3H5NJhYusExQfKusWggJxMdkfAg5VmPhYd","https://etherscan.io/address/0x1dee3868D0f77f2dB5F7465D89Ce51295106F223"],"categories":["Objective-C"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapparition47%2FMailTrackerBlocker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapparition47%2FMailTrackerBlocker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapparition47%2FMailTrackerBlocker/lists"}