{"id":13596705,"url":"https://github.com/mmotti/pihole-regex","last_synced_at":"2025-08-08T10:37:17.191Z","repository":{"id":39174317,"uuid":"137690534","full_name":"mmotti/pihole-regex","owner":"mmotti","description":"Custom regex filter list for use with Pi-hole.","archived":false,"fork":false,"pushed_at":"2024-04-27T00:47:02.000Z","size":730,"stargazers_count":1353,"open_issues_count":14,"forks_count":171,"subscribers_count":75,"default_branch":"master","last_synced_at":"2025-05-15T23:03:33.372Z","etag":null,"topics":["adblocking","blocking","filter","hostsfile","pi-hole","pi-hole-blocklists","pi-hole-ftl","regex"],"latest_commit_sha":null,"homepage":"","language":"Python","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/mmotti.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}},"created_at":"2018-06-17T22:14:56.000Z","updated_at":"2025-05-06T16:24:03.000Z","dependencies_parsed_at":"2024-08-01T16:41:51.357Z","dependency_job_id":null,"html_url":"https://github.com/mmotti/pihole-regex","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmotti%2Fpihole-regex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmotti%2Fpihole-regex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmotti%2Fpihole-regex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmotti%2Fpihole-regex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmotti","download_url":"https://codeload.github.com/mmotti/pihole-regex/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254436944,"owners_count":22070946,"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":["adblocking","blocking","filter","hostsfile","pi-hole","pi-hole-blocklists","pi-hole-ftl","regex"],"created_at":"2024-08-01T16:02:41.467Z","updated_at":"2025-05-15T23:03:52.498Z","avatar_url":"https://github.com/mmotti.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"## Regex Filters for Pi-hole\nThis is a custom regex filter file for use with Pi-hole v4+ (FTLDNS).\n\nThe purpose of this list is to compliment your existing blocklists using powerful regular expressions that can cover a very broad range of domains. A single regular expression can block thousands of 'bad' domains, and can even accommodate for domains following specific patterns that may not even (yet) exist on standard blocklists.\n\nThere are also some optional regex filters separate to the main installer that can be added manually (if desired):\n* [Facebook](https://github.com/mmotti/pihole-regex/tree/master/social)\n* [Miscellaneous Items](https://github.com/mmotti/pihole-regex/tree/master/miscellaneous)\n* [User Suggested](https://github.com/mmotti/pihole-regex/tree/master/user%20suggested)\n\nAll commands will need to be entered via Terminal (PuTTY or your SSH client of choice) after logging in and [**Python 3.6+**](https://github.com/mmotti/pihole-regex/issues/16) is required.\n\n### Add to Pi-Hole\n```\ncurl -sSl https://raw.githubusercontent.com/mmotti/pihole-regex/master/install.py | sudo python3\n```\n\n### Remove from Pi-Hole\n```\ncurl -sSl https://raw.githubusercontent.com/mmotti/pihole-regex/master/uninstall.py | sudo python3\n```\n\n### False Positives ###\nDue to the restrictive nature of these regexps, you may encounter a small number of false positives for domain names that are similar to ad-serving / tracking domains. I have created a [whitelist file](https://raw.githubusercontent.com/mmotti/pihole-regex/master/whitelist.list) to populate with user reported false positives. Please note that this file is not currently referenced during installation and is intended to be used only if you experience issues or for reference purposes.\n\n### Keep regexps up-to-date with cron (optional)\nThe following instructions will create a cron job to run every monday at 02:30 (adjust the time to suit your needs):\n\n1. Edit the root user's crontab (`sudo crontab -u root -e`)\n\n2. Enter the following:\n```\nSHELL=/bin/bash\nPATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin\n30 2 * * 1 /usr/bin/curl -sSl https://raw.githubusercontent.com/mmotti/pihole-regex/master/install.py | /usr/bin/python3\n```\n3. Save changes\n\n#### Removing the manually created cron job\nIf this script is the only thing you've added to the root user's crontab, you can run:\n\n`sudo crontab -u root -r`\n\nOtherwise, run:\n\n`sudo crontab -u root -e` and remove the three lines listed above in the install instructions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmotti%2Fpihole-regex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmotti%2Fpihole-regex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmotti%2Fpihole-regex/lists"}