{"id":17660925,"url":"https://github.com/soulteary/hosts-blackhole","last_synced_at":"2025-08-23T06:39:09.749Z","repository":{"id":65194346,"uuid":"497937937","full_name":"soulteary/hosts-blackhole","owner":"soulteary","description":"BEST hosts list processing helper for ad-blocking/blocker programs: AdGuard, AdAway, blocky, grimd...","archived":false,"fork":false,"pushed_at":"2023-06-01T20:31:18.000Z","size":132,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-28T16:55:30.573Z","etag":null,"topics":["ad-blocker","adaway","adaway-blocklist","adguard","adguard-blocklist","blocky","grimd"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soulteary.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-30T12:41:13.000Z","updated_at":"2023-09-08T18:35:00.000Z","dependencies_parsed_at":"2024-06-20T09:28:14.794Z","dependency_job_id":"896bcc00-0805-44e0-8b38-3e2b3ec5ab2b","html_url":"https://github.com/soulteary/hosts-blackhole","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/soulteary/hosts-blackhole","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulteary%2Fhosts-blackhole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulteary%2Fhosts-blackhole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulteary%2Fhosts-blackhole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulteary%2Fhosts-blackhole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soulteary","download_url":"https://codeload.github.com/soulteary/hosts-blackhole/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulteary%2Fhosts-blackhole/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271745679,"owners_count":24813521,"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-08-23T02:00:09.327Z","response_time":69,"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":["ad-blocker","adaway","adaway-blocklist","adguard","adguard-blocklist","blocky","grimd"],"created_at":"2024-10-23T17:09:44.740Z","updated_at":"2025-08-23T06:39:09.727Z","avatar_url":"https://github.com/soulteary.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hosts Blackhole\n\n[![Security Scan](https://github.com/soulteary/hosts-blackhole/actions/workflows/scan.yml/badge.svg)](https://github.com/soulteary/hosts-blackhole/actions/workflows/scan.yml) [![Release](https://github.com/soulteary/hosts-blackhole/actions/workflows/release.yaml/badge.svg)](https://github.com/soulteary/hosts-blackhole/actions/workflows/release.yaml) ![](https://img.shields.io/badge/AdAway-hosts-brightgreen) ![](https://img.shields.io/badge/AdGuard-domains-brightgreen) ![](https://img.shields.io/badge/StevenBlack-hosts-brightgreen) ![](https://img.shields.io/badge/NoTrack-blocklists-brightgreen)\n\n[![License: Apache v2](https://img.shields.io/badge/LICENSE-Apache%20v2-blue)](/LICENSE.md)\n\n\u003cimg src=\"./logo.png\" width=\"120px\" /\u003e\n\nBEST hosts list processing helper for ad-blocking/blocker programs: AdGuard, AdAway, blocky, grimd...\n\n## Data sources Supported\n\nCurrently supported data sources:\n\n\u003ctable\u003e\u003cthead\u003e\u003ctr\u003e\u003cth\u003eProject\u003c/th\u003e\u003cth\u003eFiles\u003c/th\u003e\u003c/tr\u003e\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\u003ctd\u003e\n\u003ca href=\"https://github.com/StevenBlack/hosts\"\u003eStevenBlack/hosts\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts\"\u003eFile\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\n\u003ctr\u003e\u003ctd\u003e\n\u003ca href=\"https://gitlab.com/quidsup/notrack-blocklists\"\u003equidsup/notrack-blocklists\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"https://gitlab.com/quidsup/notrack-blocklists/raw/master/notrack-blocklist.txt\"\u003eFile1\u003c/a\u003e / \u003ca href=\"https://gitlab.com/quidsup/notrack-blocklists/raw/master/notrack-malware.txt\"\u003eFile2\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\n\u003ctr\u003e\u003ctd\u003e\n\u003ca href=\"https://github.com/AdAway/adaway.github.io/\"\u003eAdAway/adaway.github.io\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"https://github.com/AdAway/adaway.github.io/blob/master/hosts.txt\"\u003eFile1\u003c/a\u003e / \u003ca href=\"https://adaway.org/hosts.txt\"\u003eFile2\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\n\u003ctr\u003e\u003ctd\u003e\n\u003ca href=\"https://github.com/AdguardTeam/AdGuardSDNSFilter\"\u003eAdguardTeam/AdGuardSDNSFilter\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd\u003e\u003ca href=\"https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt\"\u003eFile\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\n\u003c/tbody\u003e\u003c/table\u003e\n\nHosts Count:\n\n```bash\n - AdAway default blocklist  =        7038   \n - AdGuard DNS filter        =       45842   \n - StevenBlack/hosts         =      143542   \n - NoTrack Tracker Blocklist =       14698   \n - NoTrack Malware Blocklist =         305  \n```\n\n## Docker\n\nYou can download images from dockerhub, get up and running quickly:\n\n```bash\ndocker run --rm -it -p 8345:8345 \\\n    -v `pwd`/data:/data \\\n    -v `pwd`/cache:/cache \\\n    soulteary/hosts-blackhole\n```\n\n## CLI \u0026\u0026 ENV\n\nCLI parameters:\n\n```bash\n  --debug      enable debug mode\n  --port int   web port (default 8345)\n```\n\nusage: `./hbh --port=8345 --debug=false`\n\nEnv variables:\n\n```bash\nHBH_DEBUG=true\nHBH_PORT=1024\n```\n\nusage: `HBH_DEBUG=true HBH_PORT=1024 ./hbh`\n\n## APIs \u0026\u0026 Pages\n\nAPI:\n\n- `/data/hosts.txt` Get data file which contains all domains.\n- `/ping` Health check\n- `/purge` Attempt to reanalyze the data file and generate a cache file\n\nPages:\n\n- `/` Homepage\n- `/list` View available data sources\n- `/data` Data source index page\n- `/stats` System stats\n\n## Screenshot\n\n![](./screenshot/home.png)\n\n![](./screenshot/list.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoulteary%2Fhosts-blackhole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoulteary%2Fhosts-blackhole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoulteary%2Fhosts-blackhole/lists"}