https://github.com/willidieente/betterblocklist
Powerful and Customizable DNS Blocklists against Ads, Tracking, and privacy harming services! Updated Regularly with support for Pi-Hole, AdGuard, uBlock Origin and host Files.
https://github.com/willidieente/betterblocklist
adblock adblock-list blacklist blocklist blocklists dns filter-lists pi-hole pi-hole-blocklists pi-hole-lists pihole pihole-adblocker-list pihole-ads-list pihole-blocklists piholeblocklist privacy privacy-protection telemetry tracking youtube-ads
Last synced: 3 months ago
JSON representation
Powerful and Customizable DNS Blocklists against Ads, Tracking, and privacy harming services! Updated Regularly with support for Pi-Hole, AdGuard, uBlock Origin and host Files.
- Host: GitHub
- URL: https://github.com/willidieente/betterblocklist
- Owner: WilliDieEnte
- License: mit
- Created: 2022-01-03T19:09:00.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-24T20:02:21.000Z (about 1 year ago)
- Last Synced: 2025-04-03T06:36:56.576Z (about 1 year ago)
- Topics: adblock, adblock-list, blacklist, blocklist, blocklists, dns, filter-lists, pi-hole, pi-hole-blocklists, pi-hole-lists, pihole, pihole-adblocker-list, pihole-ads-list, pihole-blocklists, piholeblocklist, privacy, privacy-protection, telemetry, tracking, youtube-ads
- Homepage: https://ente.dev/api/blocklist/
- Size: 56.6 KB
- Stars: 34
- Watchers: 4
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# BetterBlocklist
Better Blocklist is a collection of powerful and customizable DNS Blocklists against Ads, Tracking and privacy harming Services.
Updated regularly with support for Pi-Hole, AdGuard(-Home), uBlock Origin and host Files.
Please contribute if you have any suggestions by opening an Issue.
> [!IMPORTANT]
> ### Please note that the lists are not hosted on GitHub and therefore no activity is shown in this Repository, although they are getting updated daily :)
# Details
A collection of Blocklists for various Purposes.
In comparison to other lists, which are all or nothing, you can exactly choose what you want to block.
If you find something in a list that you believe is a mistake or breaks functionality, please contact me.
The same goes for unblocked subdomains of blocked root domains, please let me know, so I can add it properly.
These Blocklists are compatible with all devices, regardless of the OS, speed up Page Loading, let pages look cleaner, remove most Ads, enhance Privacy, lower bandwidth, CPU, memory and battery usage.
> [!CAUTION]
>
Google has already killed Manifest v2 support in Chrome and all browsers using its engine!
> Make sure to switch to any non Chromium browser like Firefox / LibreWolf / Floorp / WaterFox or similar!
> Opera(GX), Vivaldi, Arc, Microsoft Edge and other Chromium forks will not suffice!
[^1]
[^1]: Exception for Brave, as they are still actively trying to make v2 work and have their own AdBlocker.
# Usage
with Pi-Hole
1. Use any List you like from the tables below in the **domains** format and **copy** its link to your clipboard. Pi-Hole will also work with hosts, but will remove the 0.0.0.0 entries when preparing them for the FTL, therefore taking longer to update and wasting resources.
2. Add the URL to your Pi-hole's blocklists
(**Group Management** -> **Adlists** -> Paste the copied URL into the **"Address" field**; optionally add a comment -> finally **Add** it)
4. Update Gravity, to apply it instantly
(**Tools** -> **Update Gravity** -> Click **Update**)
Instructions for Pi-Hole v5, v6 isn't out yet at time of writing, but may slightly differ
> [!TIP]
>
I very much recommend you to use unbound in addition to Pi-Hole for better Privacy.
with AdGuardHome
1. Use any List you like from the tables below in the **domains** format and **copy** its link to your clipboard. They'll work perfectly as intended, I just don't yet provide them in AdGuard's own formatting.
2. Add the URL to your AdGuard's block list
(**Filters** -> **DNS Blocklists** -> **Add blocklist** -> **Add a custom list** -> **Enter any Name** -> **Paste copied URL**)
3. List is enabled automatically and will be used to block requests.
with uBlock Origin (similar process for AdGuard and comparable Add-ons)
1. Use any List you like from the tables below in the **domains** format and **copy** its link to your clipboard.
2. Click on the **uBlock icon** at the top right, or if it isn't there, click on your Extensions Menu and look for "uBlock Origin". (Potentially top right menu and then Extensions if you've disabled the quick icon)
3. If you've found and clicked on it, a menu will appear. By default, you should see **two gears** at the **bottom right** of the menu; click on them. In case you don't see any gears, click "More ↓" until they appear.
5. A new tab with the uBlock Dashboard will open.
6. Click on **Filter Lists** in the top bar.
7. (if applicable) scroll down.
8. Click on **Import...**
9. **Paste** the URL you copied and repeat with as many as you wish.
10. Click **Apply changes** at the top left.
11. Done, it'll automatically update now and in the background.
> [!NOTE]
>
Keep in mind that Firefox for Android supports extensions like uBlock.
> Alternatively, projects like Cromite are awesome as well.
Host files (Directly on system)
Host file locations:
- **Linux**, Unix and Mac OS X -> ``/etc/hosts``
- Windows XP, Vista, 7, 8, **10 and 11** -> ``C:\WINDOWS\system32\drivers\etc\hosts``
- Windows 2000 -> ``C:\WINNT\system32\drivers\etc\hosts``
- Windows 98/ME -> ``C:\WINDOWS\hosts``
1. Locate your **O**perating **S**ystem and open up the file, specified at the path above.
2. Open up any list from the tables below in the **hosts** format.
3. Manually copy the entries you'd like to add into the file and save.
**Windows users, beware as to keep the size of the file under 1MB!!!**
Otherwise, no lookups will be made at all, and you won't be able to connect to the internet!
> [!WARNING]
> Do not use Host files larger than 1MB on Windows directly, Windows can't handle that and won't do any lookups anymore for some obscure reason. Rather use Pi-Hole or AdGuardHome
On Android I recommend using AdAway and on iOS Blokada.
# Lists
| List | Description | Link |
|--| -- |--|
| Advertising | Advertisement servers / sites | domains, hosts |
| Google-AMP | Blocks Google AMP pages | domains, hosts |
| Suspicious | Includes fraud, scams, malware, phishing, etc. | domains, hosts |
| Tracking | Sites and services dedicated to gathering info about you | domains, hosts |
| TV | Smart TV & Fire TV telemetry and ads | domains, hosts |
| TikTok | Blocks TikTok, formerly known as Musically | domains, hosts |
| YouTube-Ads | Blocks some[^2] ads without blocking actual YouTube videos | Deprecated |
[^2]: This is pretty whack-a-mole and will never be perfect, especially with YouTube now testing server side inserted Advertisements, which make this impossible :/
> [!TIP]
> All lists are accessible using the following Scheme:
>
- Domains only: https://ente.dev/api/blocklist/blocklist-name/
>
- Host Files: https://ente.dev/api/blocklist/blocklist-name-hosts/
>
Example: https://ente.dev/api/blocklist/suspicious or https://ente.dev/api/blocklist/tracking-hosts
# Experimental Lists
| List | Description | Link |
|--| -- |--|
| Amazon | Tries to block Amazon, without blocking AWS | domains, hosts |
| Apple | An Apple a day keeps your money away! | domains, hosts |
| Cloudflare | Blocks the Cloudflare Network | domains, hosts |
| Crypto | Blocks crypto sites and prevents mining | domains, hosts |
| Facebook | Detects Facebook, Messenger & Marketplace | domains, hosts |
| Gambling | Attempts to block legal & illegal Gambling services | domains, hosts |
| Google | Blocks Google services, without interfering YouTube[^3] | domains, hosts |
| Instagram | Hinders usage of Instagram | domains, hosts |
| Microsoft | Attempts to block all Microsoft services, including Skype | domains, hosts |
| Pinterest | Blocks Pinterest | domains, hosts |
| Reddit | Reddit < actual Forums imo | domains, hosts |
| Snapchat | Blocks the usage of Snapchat | domains, hosts |
| Twitter | Blocks the trash Fire Twitter X? | domains, hosts |
| Vaping | Vaping isn't better than smoking lol | domains, hosts |
| WhatsApp | Prevents sending & reciving of WhatsApp messages | domains, hosts |
| YouTube | Stops YouTube Usage | domains, hosts |
[^3]: This will still prevent logging into YouTube, as it blocks Google's OAuth; already logged-in sessions will remain.
Please open an Issue if you find any false flag or have any Domain(s) that should be added to any Blocklist.
# Awesome Projects
Thanks to the following, great Projects that are partially included in BetterBlocklist adding to my own Research (and maybe even yours, I would appreciate your Contribution :)
- https://blocklist-tools.developerdan.com/blocklists
- https://prism-break.org/
- https://github.com/gorhill/uBlock
- https://adblockplus.org/
- https://privacyguides.org/
- https://adguard.com/
- https://adaway.org/
- https://disconnect.me/
- https://firebog.net/
- https://hmirror.molinero.dev/
- https://coveryourtracks.eff.org/
# To-Do
- [ ] Public uptime page to properly track the API modules https://github.com/WilliDieEnte/BetterBlocklist/issues/6
- [ ] Add ABP Variants https://github.com/WilliDieEnte/BetterBlocklist/issues/22
- [ ] Recode and open-source of the crawler
# Additions
- Dependencies are updated automatically every day.
- Why should I avoid CCleaner?
- The ente.dev Domain uses Cloudflare Argo Smart Routing, CDN and Tiered Cache in combination with multiple servers at different locations, managed via load balancing for the fastest delivery possible globally, so you shouldn't experience much delay in pulling updates from these lists.
A great way of finding fake shops is just searching the following keywords:
- Kindly keep in mind that we produce on demand. We do not stock items
- Every day we receive more appreciative emails from satisfied customers all over the world
- Everyday, we strive to deliver high quality products with the greatest customer experience possible
If you have any questions about this project, open an issue and let's have a discussion! :3
# Disclaimer
The lists contained here are provided as is, with no warranty as to their accuracy. It is your responsibility to whitelist/blacklist as you see fit for your needs and your environment. These lists are provided free of charge, are open for use by anyone, and are maintained by myself in my spare time. These lists are collections of domains I have come across; therefore, these are not perfectly curated and vetted lists; however, I try to do my best to avoid false positives and inaccuracies in all cases.