{"id":30763523,"url":"https://github.com/eikarna/adzerolist","last_synced_at":"2025-09-04T16:05:38.791Z","repository":{"id":305495249,"uuid":"1023033679","full_name":"eikarna/AdZeroList","owner":"eikarna","description":"For better, faster and safer internet!","archived":false,"fork":false,"pushed_at":"2025-09-01T07:06:55.000Z","size":509604,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-01T07:30:37.529Z","etag":null,"topics":["adblock","adblocker","adblocker-lists","automation","bash","bash-script","blocklist","easylist","open-source","shell-script","whitelist"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/eikarna.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-20T11:40:02.000Z","updated_at":"2025-09-01T07:07:06.000Z","dependencies_parsed_at":"2025-07-25T23:28:41.852Z","dependency_job_id":"3a662d22-7a12-4e4a-b1ce-6203997df1a7","html_url":"https://github.com/eikarna/AdZeroList","commit_stats":null,"previous_names":["eikarna/autohosts","eikarna/adzerolist"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/eikarna/AdZeroList","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eikarna%2FAdZeroList","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eikarna%2FAdZeroList/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eikarna%2FAdZeroList/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eikarna%2FAdZeroList/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eikarna","download_url":"https://codeload.github.com/eikarna/AdZeroList/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eikarna%2FAdZeroList/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273633540,"owners_count":25140778,"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","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["adblock","adblocker","adblocker-lists","automation","bash","bash-script","blocklist","easylist","open-source","shell-script","whitelist"],"created_at":"2025-09-04T16:04:49.568Z","updated_at":"2025-09-04T16:05:38.742Z","avatar_url":"https://github.com/eikarna.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AdZeroList: Automated Hosts File Generator\n\n[![Build Status](https://github.com/eikarna/AdZeroList/workflows/Build%20and%20Deploy%20Blocklists/badge.svg)](https://github.com/eikarna/AdZeroList/actions/workflows/unified-build.yml)\n[![Latest Release](https://img.shields.io/github/v/release/eikarna/AdZeroList?label=latest%20release)](https://github.com/eikarna/AdZeroList/releases/latest)\n\nWelcome to **AdZeroList**! This repository is your go-to solution for automatically generating clean, compressed, and deduplicated `hosts` files. Powered by GitHub Actions, our process ensures your `hosts` file is always up-to-date, providing you with a seamless ad-blocking experience.\n\n## ✨ Features\n\n-   **Automated \u0026 Always Fresh**: Our blocklists are automatically generated daily at 02:00 UTC via GitHub Actions, ensuring you always have the latest protection without any manual intervention.\n-   **Production-Ready Sources**: Curated with the best source combinations - Hagezi Pro++, 1Hosts Pro, comprehensive AdBlock filters, and security-focused lists.\n-   **Format-Optimized Sources**: Uses dedicated source lists optimized for each format - DNS-level sources for hosts/dnsmasq/smartdns/BIND/Blocky/Unbound, and specialized filter sources for adblocker formats.\n-   **Multiple Format Support**: Generate blocklists in 9 different formats including traditional `hosts` files, DNS server configs, and adblocker formats.\n-   **Custom Filter Support**: Add your own custom domains (DNS-level) and custom AdBlock filters (browser-level) for personalized blocking.\n-   **Enhanced AdBlock Filters**: AdBlock formats combine both converted domain lists and native AdBlock filter rules for comprehensive protection.\n-   **Highly Efficient**: We optimize `hosts` files by combining multiple host entries into a single line (1 IP for up to 8 domains), significantly reducing file size and improving performance.\n-   **Deduplicated \u0026 Clean**: Say goodbye to redundant entries! Our process meticulously deduplicates all entries, providing you with a clean and efficient blocklist.\n-   **Flexible Source Management**: Easily manage your sources by editing the appropriate source files. Add, remove, or temporarily disable sources with ease.\n-   **Comprehensive Protection**: Blocks ads, trackers, malware, phishing, cryptomining, and annoying elements across all platforms.\n\n## 🚀 Usage\n## 🔗 Direct Download Links (Recommended)\n\n**For better browser compatibility, use these direct links instead of GitHub releases:**\n\n### Browser Adblockers\n- **Brave Browser**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/adblock.txt`\n- **uBlock Origin**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/ublock.txt`\n\n### DNS Servers  \n- **Hosts format**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/hosts.txt`\n- **Hosts uncompressed**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/hosts-uncompressed.txt`\n- **Dnsmasq**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/dnsmasq.conf`\n- **SmartDNS**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/smartdns.conf`\n- **BIND RPZ**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/bind-rpz.conf`\n- **Blocky**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/blocky.yml`\n- **Unbound**: `https://raw.githubusercontent.com/eikarna/AdZeroList/main/outputs/unbound.conf`\n\n\u003e **Note**: GitHub releases may have compatibility issues with some browsers/downloaders. The `raw.githubusercontent.com` links provide direct access without redirect issues.\n\n\nGetting started with AdZeroList is simple! You can download the latest generated files directly from our **[Releases page](https://github.com/eikarna/AdZeroList/releases)**.\n\n### Available Formats\n\nAdZeroList generates blocklists in multiple formats to support different applications:\n\n**DNS Server Formats:**\n- **`hosts.txt`** - Traditional hosts file format (compressed, multiple domains per line)\n- **`hosts-uncompressed.txt`** - Traditional hosts file format (one domain per line)\n- **`dnsmasq.conf`** - Configuration file for dnsmasq DNS server\n- **`smartdns.conf`** - Configuration file for SmartDNS\n- **`bind-rpz.conf`** - BIND Response Policy Zones configuration\n- **`blocky.txt`** - Blocky domain wildcard format\n- **`unbound.conf`** - Unbound DNS server configuration\n\n**Browser Extension Formats:**\n- **`adblock.txt`** - AdBlock Plus format (compatible with Brave, AdBlock Plus, and most browser extensions)\n- **`ublock.txt`** - uBlock Origin optimized format (enhanced metadata for uBlock Origin)\n\n### Browser Extension Usage\n\nFor browser-based ad blockers:\n1. Download `adblock.txt` for general compatibility with AdBlock Plus, Brave, and similar extensions\n2. Download `ublock.txt` for optimal performance with uBlock Origin\n3. Add the downloaded file as a custom filter list in your adblocker settings\n\n### DNS Server Usage\n\nFor DNS-level blocking:\n\n**BIND (Response Policy Zones):**\n1. Download `bind-rpz.conf`\n2. Add to your BIND configuration as a response policy zone\n3. Configure the zone in your `named.conf`\n\n**Blocky:**\n1. Download `blocky.txt`\n2. Add the file path to your blocky blacklists configuration\n3. Restart blocky service\n\n**Unbound:**\n1. Download `unbound.conf`\n2. Include the file in your main `unbound.conf` configuration\n3. Restart unbound service\n\n**dnsmasq:**\n1. Download `dnsmasq.conf`\n2. Include in your dnsmasq configuration directory\n3. Restart dnsmasq service\n\n**SmartDNS:**\n1. Download `smartdns.conf`\n2. Include in your SmartDNS configuration\n3. Restart SmartDNS service\n\n**Traditional hosts file:**\n1. Download `hosts.txt` or `hosts-uncompressed.txt`\n2. Append to your system's hosts file (`/etc/hosts` on Linux/macOS, `C:\\Windows\\System32\\drivers\\etc\\hosts` on Windows)\n3. No service restart required\n\nEach release is tagged with a unique identifier and includes detailed information, such as the commit hash that triggered the build and the SHA256 hashes of the `hosts.txt` file, allowing you to verify its integrity and track changes.\n\n### Verifying `hosts.txt` Integrity\n\nEvery release body includes the SHA256 hash of the `hosts.txt` file. You'll find two hashes:\n\n-   **Old Hash**: The SHA256 hash of the `hosts.txt` from the *previous* successful build.\n-   **New Hash**: The SHA256 hash of the `hosts.txt` generated in the *current* build.\n\nThis allows you to quickly see if the `hosts.txt` content has changed between releases. If the old and new hashes are different, it indicates that the `hosts.txt` file has been updated.\n\n## 🔧 How It Works\n\n1.  **Trigger**: Our GitHub Actions workflow is triggered daily at 02:00 UTC, or whenever there's a `push` to the `main` branch, ensuring continuous updates.\n2.  **Compilation**: The `hostpress.c` program, the core of our processing, is compiled using `Makefile`.\n3.  **Download Sources**: All active (uncommented) URLs listed in `sources.list` are downloaded to gather the latest blocklist data.\n4.  **Customization**: Domains specified in `custom.list` are seamlessly integrated into the blocklist.\n5.  **Processing**: The `hostpress` program takes over, cleaning, sorting, deduplicating, and compressing all entries for optimal performance.\n6.  **Whitelisting**: Domains listed in `custom-white.list` are carefully removed from the processed `hosts` file, ensuring your essential services remain unaffected.\n7.  **Release**: The final, optimized files in multiple formats (hosts, dnsmasq, smartdns, BIND RPZ, Blocky, Unbound, and adblocker formats) are uploaded as assets to a new GitHub release.\n\n## 💻 Customization\n\nWant to fine-tune your ad-blocking experience? Here's how:\n\n### Source Management\n\nThe system uses production-ready, curated source lists for maximum effectiveness:\n\n**DNS-Level Sources (`lists/sources-dns.list`):**\n- **Hagezi Pro++** - Most comprehensive, highly maintained DNS blocklist\n- **1Hosts Pro** - High-quality curated domain list  \n- **StevenBlack's Unified** - Ads + malware + fakenews + gambling\n- **OISD Big** - Comprehensive domain blocking\n- **Security Sources** - Phishing Army, URLHaus, Malware Domain List\n- **Privacy Sources** - NoTracking, AdAway, GoodbyeAds\n\n**AdBlock Sources (`lists/sources-adblock.list`):**\n- **Core Filters** - EasyList, EasyPrivacy (essential)\n- **uBlock Origin** - Native uBlock filters, privacy, badware, resource abuse\n- **AdGuard** - Base filter, tracking protection, mobile optimization\n- **Annoyance** - Fanboy's annoyance, social blocking\n- **Security** - Anti-phishing, anti-malware filters\n- **Regional** - Optimized for multiple languages\n\n**Legacy Sources (`lists/sources.list`):**\n- Maintained for backward compatibility\n- Automatically included in DNS formats\n\n### Custom Filters\n\n**Custom Domains (`lists/custom.list`):**\n- Add domains for DNS-level blocking across all formats\n- Applied to hosts, dnsmasq, smartdns, BIND, Blocky, Unbound\n\n**Custom AdBlock Filters (`lists/custom-adblock.list`):**\n- Add native AdBlock filter rules for browser extensions\n- Supports all AdBlock Plus/uBlock Origin syntax\n- Element hiding, URL blocking, advanced rules\n\n**Whitelist (`lists/custom-white.list`):**\n- Exclude domains from all generated blocklists\n- Prevent blocking of essential services\n\nYour changes will automatically trigger a new build after you `push` to the `main` branch, so you'll see your customizations in action quickly!\n\n## 📜 Current Sources\n\n### DNS-Level Sources (Optimized for hosts, dnsmasq, smartdns, BIND, Blocky, Unbound)\n- [Hagezi DNS Blocklist Pro++](https://github.com/hagezi/dns-blocklists) - Most comprehensive, highly maintained\n- [1Hosts Pro](https://github.com/badmojr/1Hosts) - High-quality curated list\n- [StevenBlack's Unified hosts](https://github.com/StevenBlack/hosts) - Ads + malware + fakenews + gambling\n- [OISD Big](https://oisd.nl/) - Comprehensive domain blocking\n- [AdAway](https://adaway.org/) - Mobile-focused blocking\n- [GoodbyeAds](https://github.com/jerryn70/GoodbyeAds) - Smart TV ads blocking\n- [NoTracking](https://github.com/notracking/hosts-blocklists) - Privacy-focused\n- [Phishing Army](https://phishing.army/) - Anti-phishing protection\n- [Malware Domain List](https://www.malwaredomainlist.com/) - Security focused\n- [URLHaus](https://urlhaus.abuse.ch/) - Malware URL blocking\n\n### AdBlock Sources (Optimized for browser extensions)\n- [EasyList](https://easylist.to/) - Core ad blocking (essential)\n- [EasyPrivacy](https://easylist.to/) - Privacy protection and tracking prevention\n- [uBlock Origin filters](https://github.com/uBlockOrigin/uAssets) - Native uBlock filters, privacy, badware, resource abuse\n- [AdGuard filters](https://github.com/AdguardTeam/AdguardFilters) - Base filter, tracking protection, mobile optimization\n- [Fanboy's lists](https://easylist.to/) - Annoyance and social blocking\n- Anti-phishing and anti-malware filters\n- Regional optimization filters\n\n---\n*Created with the help of Gemini.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feikarna%2Fadzerolist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feikarna%2Fadzerolist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feikarna%2Fadzerolist/lists"}