{"id":13591877,"url":"https://github.com/facebook-adblock/facebook_adblock","last_synced_at":"2025-04-08T18:30:57.862Z","repository":{"id":37047406,"uuid":"61241605","full_name":"facebook-adblock/facebook_adblock","owner":"facebook-adblock","description":"An open-source Ad Blocker for Facebook™","archived":false,"fork":false,"pushed_at":"2023-02-12T14:59:23.000Z","size":4096,"stargazers_count":215,"open_issues_count":17,"forks_count":42,"subscribers_count":15,"default_branch":"mainline","last_synced_at":"2024-11-06T12:45:30.963Z","etag":null,"topics":["browser-extension","chrome-extension","facebook","facebook-adblock","firefox-addon","javascript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/facebook-adblock.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-06-15T21:18:43.000Z","updated_at":"2024-11-02T02:15:11.000Z","dependencies_parsed_at":"2024-01-14T04:01:00.422Z","dependency_job_id":"382c83e8-bf0e-4968-b190-e198003d6050","html_url":"https://github.com/facebook-adblock/facebook_adblock","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook-adblock%2Ffacebook_adblock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook-adblock%2Ffacebook_adblock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook-adblock%2Ffacebook_adblock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook-adblock%2Ffacebook_adblock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facebook-adblock","download_url":"https://codeload.github.com/facebook-adblock/facebook_adblock/tar.gz/refs/heads/mainline","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247901976,"owners_count":21015375,"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":["browser-extension","chrome-extension","facebook","facebook-adblock","firefox-addon","javascript"],"created_at":"2024-08-01T16:01:03.227Z","updated_at":"2025-04-08T18:30:55.235Z","avatar_url":"https://github.com/facebook-adblock.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# facebook_adblock\n\nAn open-source Ad Blocker for Facebook™\n\n- Support the FB5 layout (Thanks to [Christos Botsikas](https://github.com/cbotsikas))\n- Blocks both suggested posts and sidebar ads\n- Does not slow down your computer\n- Does not track/read your Facebook activity, or other websites\n- You can inspect everything about this extension here, https://github.com/facebook-adblock/facebook_adblock/blob/mainline/src/main.js\n\nThis extension is 100% free and open source.\n\n## Installation\n\n### Chrome\n\nhttps://chrome.google.com/webstore/detail/ad-blocker-for-facebook/kinpgphmiekapnpbmobneleaiemkefag\n\n[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/kinpgphmiekapnpbmobneleaiemkefag.svg)](https://chrome.google.com/webstore/detail/ad-blocker-for-facebook/kinpgphmiekapnpbmobneleaiemkefag)\n[![Chrome Web Store](https://img.shields.io/chrome-web-store/users/kinpgphmiekapnpbmobneleaiemkefag.svg)](https://chrome.google.com/webstore/detail/ad-blocker-for-facebook/kinpgphmiekapnpbmobneleaiemkefag)\n[![Chrome Web Store](https://img.shields.io/chrome-web-store/stars/kinpgphmiekapnpbmobneleaiemkefag.svg)](https://chrome.google.com/webstore/detail/ad-blocker-for-facebook/kinpgphmiekapnpbmobneleaiemkefag)\n\n### Firefox\n\nhttps://addons.mozilla.org/en-US/firefox/addon/fb_ad_block/ (Thanks to [Chih-Hsuan Yen](https://github.com/yan12125))\n\n[![Mozilla Add-on](https://img.shields.io/amo/v/fb_ad_block.svg)](https://addons.mozilla.org/en-US/firefox/addon/fb_ad_block/)\n[![Mozilla Add-on](https://img.shields.io/amo/users/fb_ad_block.svg)](https://addons.mozilla.org/en-US/firefox/addon/fb_ad_block/)\n[![Mozilla Add-on](https://img.shields.io/amo/stars/fb_ad_block.svg)](https://addons.mozilla.org/en-US/firefox/addon/fb_ad_block/)\n\nEnjoy!\n\n_We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with Facebook._\n\n_Facebook is a registered trademark of the Facebook, Inc._\n\n## Building\n\n1. Run `npm run release`\n1. The compiled extension should be in `dist/`\n1. Load the unsigned extension into your browser\n\n## Debugging\n\nAll processed DOM elements are flagged with `data-blocked` attribute. Possible values are:\n\n- `allowedList`: allowed list\n- `blockedList`: blocked due to blocked list check\n- `sponsored`: blocked due to sponsored label\n\nYou can use dev tools console with CSS selectors like `*[data-blocked]` or `*[data-blocked=sponsored]`.\n\nFor example add inline style properties to all existing hidden sponsored posts:\n\n```\ndocument.querySelectorAll(\"*[data-blocked=sponsored]\").forEach((x) =\u003e {\n  x.style.display=\"inherit\";\n  x.style.border=\"red 10px solid\";\n});\n```\n\nYou can also inject css which applies to both existing and new processed elements:\n\n```\ndocument.head.insertAdjacentHTML(\"beforeend\",\n`\u003cstyle\u003e\n  *[data-blocked] {\n    display:inherit !important;\n    border: red 10px solid;\n  }\n  *[data-blocked=allowedList] {\n    border-color: green;\n  }\n  *[data-adblocked] {\n    display:inherit !important;\n    border: pink 10px solid;\n  }\n  *[data-adblock-monitored] {\n    border: blue 10px solid;\n  }\n  *[data-adblock-observed] {\n    border: aqua 10px solid;\n  }\n\u003c/style\u003e`);\n```\n\n## Publishing\n\n1. Tag a commit with a string with this format `v*.*.*`\n   - `git tag -a v2.0.0`\n1. Push a tag to Github\n1. Github action should publish the extension to both Firefox and Chrome\n   - Firefox should be released in a couple of minutes\n   - Chrome can take as long as a few months if it needs a review\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebook-adblock%2Ffacebook_adblock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacebook-adblock%2Ffacebook_adblock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebook-adblock%2Ffacebook_adblock/lists"}