{"id":22004611,"url":"https://github.com/r-rajaneesh/blackhole","last_synced_at":"2026-05-02T01:32:03.625Z","repository":{"id":105007006,"uuid":"600712663","full_name":"r-rajaneesh/blackhole","owner":"r-rajaneesh","description":"A local DNS server sucking ads on your network","archived":false,"fork":false,"pushed_at":"2023-06-25T06:39:49.000Z","size":9681,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T06:26:32.944Z","etag":null,"topics":["ad-blocker","blackhole","blocker","cloud","dashboard","dns","dns-server","dnsmasq","hacktoberfest","pi-hole-alternatives"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/r-rajaneesh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2023-02-12T11:06:04.000Z","updated_at":"2023-10-31T04:24:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"a44c55c4-e0ea-4254-9d3a-6a24d9f88401","html_url":"https://github.com/r-rajaneesh/blackhole","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/r-rajaneesh/blackhole","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-rajaneesh%2Fblackhole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-rajaneesh%2Fblackhole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-rajaneesh%2Fblackhole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-rajaneesh%2Fblackhole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r-rajaneesh","download_url":"https://codeload.github.com/r-rajaneesh/blackhole/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-rajaneesh%2Fblackhole/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32520156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"ssl_error","status_checked_at":"2026-05-02T01:12:54.261Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","blackhole","blocker","cloud","dashboard","dns","dns-server","dnsmasq","hacktoberfest","pi-hole-alternatives"],"created_at":"2024-11-30T00:16:35.884Z","updated_at":"2026-05-02T01:32:03.605Z","avatar_url":"https://github.com/r-rajaneesh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Blackhole](src/public/blackhole.jpg)\n\n# Blackhole\n\nBlackhole is a DNS server running on your local machine that sucks up all your ads flowing through your network\n\n## Todo\n\n[✅] **Add a way to view live DNS queries**\n\n[✅] **Add a way to allow blocking ads seperately and from a list**\n\n[❌] **Add login page**\n\n[❌] **Make dashboard look much nicer**\n\n[❌] **Implement features from** [pi-hole](https://github.com/pi-hole/pi-hole)\n\n## Installation\n\n### Setting up\n```\ngit clone https://github.com/r-rajaneesh/blackhole.git Blackhole\n\ncd Blackhole\n\ninstall.bat\n```\n\n## Running the server\n\n```\nnpm run start\n```\n\n## Author\n\n[Rajaneesh R](https://r-rajaneesh.vercel.app)\n\n\n\n# Blackhole\n\nBlackhole is a lightweight DNS ad-blocker that blocks all ads running through the network. It is a powerful tool for users who want to improve their web browsing experience and protect their privacy by blocking annoying ads and tracking scripts.\n\n# Features\n\n* Blocks nearly 1 million ad domains\n* Runs a DNS server connected with the Operating system on 127.0.0.1\n* Lightweight and fast\n* Written in Node.js and Typescript\n\n# How it Works\n\nBlackhole runs a DNS server on your local machine that blocks all requests to known ad domains by resolving them to the localhost (127.0.0.1). This means that when your computer tries to connect to an ad domain, Blackhole will intercept the request and return a null response, effectively blocking the ad from being displayed or loaded.\n\n# Installation\n\nTo install Blackhole, simply clone the repository and install the necessary dependencies:\n\n```\n$ git clone https://github.com/r-rajaneesh/blackhole.git\n$ cd blackhole\n$ npm install\n```\n\nOnce installed, you can start the Blackhole DNS server by running the following command:\n\n```\n$ npm start\n```\n\nThis will start the DNS server on your local machine, listening on port 53. You can configure your Operating system to use this DNS server by setting the DNS server address to 127.0.0.1.\n\n# Alternatives\nBlackhole is a great alternative to other popular ad-blocking solutions like Pi-hole. While Pi-hole is a great tool, it can be more complicated to set up and maintain, especially for less technical users. Blackhole is designed to be simple, fast, and lightweight, making it a great choice for anyone who wants to block ads without a lot of hassle.\n\n# License\nBlackhole is licensed under the GPL-3.0 License.\n\n# Contributing\nWe welcome contributions from anyone who is interested in helping improve Blackhole. To contribute, simply fork the repository, make your changes, and submit a pull request. We appreciate your help and feedback!\n\n# Credits\nBlackhole was created by [Rajaneesh R](https://r-rajaneesh.vercel.app).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-rajaneesh%2Fblackhole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr-rajaneesh%2Fblackhole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-rajaneesh%2Fblackhole/lists"}