{"id":13448448,"url":"https://github.com/hectorm/hblock","last_synced_at":"2025-05-13T23:04:41.684Z","repository":{"id":36842420,"uuid":"41149350","full_name":"hectorm/hblock","owner":"hectorm","description":"Improve your security and privacy by blocking ads, tracking and malware domains.","archived":false,"fork":false,"pushed_at":"2025-03-12T18:58:45.000Z","size":2956,"stargazers_count":1788,"open_issues_count":9,"forks_count":107,"subscribers_count":38,"default_branch":"master","last_synced_at":"2025-04-10T00:13:54.043Z","etag":null,"topics":["ad-blocker","adblock","adblocker","ads","advertisements","blocker","dns","dnsmasq","hosts","hostsfile","malware","privacy","protection","ransomware","security","shell","trackers","tracking","trojans","unified-hosts"],"latest_commit_sha":null,"homepage":"https://hblock.molinero.dev","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"QuickBox/QB","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hectorm.png","metadata":{"files":{"readme":"README.md","changelog":null,"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},"funding":{"github":"hectorm","custom":"https://hector.molinero.dev/donate"}},"created_at":"2015-08-21T10:05:34.000Z","updated_at":"2025-04-09T19:53:22.000Z","dependencies_parsed_at":"2023-02-16T00:31:23.046Z","dependency_job_id":"a338d370-333b-472a-80fc-b8c877bdcc09","html_url":"https://github.com/hectorm/hblock","commit_stats":{"total_commits":616,"total_committers":9,"mean_commits":68.44444444444444,"dds":0.4334415584415584,"last_synced_commit":"759a7b842fcd3e71ebce90458d5dc196f1603ca3"},"previous_names":["zant95/hblock"],"tags_count":72,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hectorm%2Fhblock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hectorm%2Fhblock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hectorm%2Fhblock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hectorm%2Fhblock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hectorm","download_url":"https://codeload.github.com/hectorm/hblock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254040540,"owners_count":22004561,"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":["ad-blocker","adblock","adblocker","ads","advertisements","blocker","dns","dnsmasq","hosts","hostsfile","malware","privacy","protection","ransomware","security","shell","trackers","tracking","trojans","unified-hosts"],"created_at":"2024-07-31T05:01:45.904Z","updated_at":"2025-05-13T23:04:36.665Z","avatar_url":"https://github.com/hectorm.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hblock.molinero.dev\"\u003e\n    \u003cimg src=\"./resources/logo/vectors/logo-a.svg\" width=\"320\" height=\"100\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Improve your security and privacy by blocking ads, tracking and malware domains.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hectorm/hblock/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/tag/hectorm/hblock?label=version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://hblock.molinero.dev\"\u003e\n    \u003cimg src=\"https://img.shields.io/website/https/hblock.molinero.dev.svg?label=nightly%20builds\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"./LICENSE.md\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/hectorm/hblock?label=license\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## What is this for?\n\nhBlock is a POSIX-compliant shell script that gets a list of domains that serve ads, tracking scripts and malware from [multiple sources](./SOURCES.md)\nand creates a [hosts file](https://en.wikipedia.org/wiki/Hosts_(file)), [among other formats](./resources/alt-formats/), that prevents your system\nfrom connecting to them.\n\n:warning: hBlock by default **replaces the hosts file of your system**, consider making a backup first if you have entries you want to preserve.\n\n## Installation\n\nhBlock is available in various package managers. Please check the [PACKAGES.md](./PACKAGES.md) file for an up-to-date list.\n\nThe latest available version can also be installed manually by running the following commands:\n\n```sh\ncurl -o /tmp/hblock 'https://raw.githubusercontent.com/hectorm/hblock/v3.5.1/hblock' \\\n  \u0026\u0026 echo 'd010cb9e0f3c644e9df3bfb387f42f7dbbffbbd481fb50c32683bbe71f994451  /tmp/hblock' | shasum -c \\\n  \u0026\u0026 sudo mv /tmp/hblock /usr/local/bin/hblock \\\n  \u0026\u0026 sudo chown 0:0 /usr/local/bin/hblock \\\n  \u0026\u0026 sudo chmod 755 /usr/local/bin/hblock\n```\n\nAdditionally, a [systemd timer](resources/systemd/) can be set to regularly update the hosts file for new additions.\n\n## Usage\n\nThe default behavior of hBlock can be adjusted with multiple options. Use the `--help` option or check the [hblock.1.md](./hblock.1.md) file for the\nfull list.\n\n[![asciicast](https://asciinema.org/a/VuQmlvjF3j6KBberJVJKcn1Oi.svg)](https://asciinema.org/a/VuQmlvjF3j6KBberJVJKcn1Oi)\n\n## Nightly builds\n\nNightly builds of the hosts file, among other formats, can be found [on the hBlock website](https://hblock.molinero.dev).\n\n## Temporarily disable hBlock\n\nSometimes you may need to temporarily disable hBlock, a quick option is to generate a hosts file without any blocked domains by running the following\ncommand:\n\n```sh\nhblock -S none -D none\n```\n\n## I found a false positive, what should I do?\n\nIt's possible that sometimes one of the hBlock sources includes a domain that shouldn't be blocked, in those cases the best way to proceed is to\ntemporarily add said domain to the allowlist and report the problem to the original blocklist author. This way it will also be automatically\nremoved from hBlock within 24h.\n\nTo find which blocklist is behind a false positive you can clone the [hMirror project](https://github.com/hectorm/hmirror) and search for that domain.\nAlthough please note that not all hMirror blocklists are used by default in hBlock, an updated list of the sources used can be found in the\n[SOURCES.md](./SOURCES.md) file.\n","funding_links":["https://github.com/sponsors/hectorm","https://hector.molinero.dev/donate"],"categories":["Shell","This project wouldn't exist without:","Table of Contents","System Utilities"],"sub_categories":["Option 3 - Local VPN (no root)","AD Blocker","Directory Navigation"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhectorm%2Fhblock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhectorm%2Fhblock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhectorm%2Fhblock/lists"}