pihole-regex

Custom RegEx, Exact, and Adlist filters for Pi-hole's FTLDNS

MIT License

Stars
65
Committers
2

Pi-hole® v5+ FTLDNS: Advanced Filter Collection

Maximize the efficiency of your Pi-hole setup with our extensive collection of Regular Expressions (RegEx) and Exact Match filters. Designed to block a broad range of domains effectively, our filters simplify your blocking strategy by minimizing the need for numerous individual entries. Additionally, this repository includes customizable Exact Match filters for precise domain blocking and tools to facilitate the easy management of Adlist Group entries.

Announcement: New Pi-hole Database Management Tool

We're excited to announce the addition of a new script to our Pi-hole toolset! The "pihole_admin.py" script is a powerful Python-based tool that provides advanced management capabilities for your Pi-hole database. Some of the key features include:

  • Optimize the Pi-hole database to reduce size and fragmentation
  • Backup the Pi-hole database to a specified location
  • Fetch comprehensive statistics about your Pi-hole setup
  • Clean up old data from the query storage
  • Add or remove domains from the whitelist and blacklist
  • Update the gravity database
  • Analyze top blocked and allowed domains
  • Run custom SQL queries on the Pi-hole databases
  • Check for Pi-hole updates
  • Remove duplicate domains across all lists
  • Find similar domains based on a specified similarity threshold

This tool is designed to simplify the management of your Pi-hole and provide deeper insights into your network's activity. You can find the script in our GitHub repository at [link-to-script].

Prerequisites

To use the "pihole_admin.py" script, you will need to install the following Python packages:

  • argparse
  • logging
  • matplotlib
  • requests
  • sqlite3
  • tabulate
  • typing
  • fuzzywuzzy

You can install these packages using pip:

pip install argparse logging matplotlib requests sqlite3 tabulate typing fuzzywuzzy

Alternatively, you can install the packages using the following commands:

sudo apt-get update
sudo apt-get install -y python3 python3-pip
pip3 install argparse logging matplotlib requests sqlite3 tabulate typing fuzzywuzzy

Quick Links

Filter Lists Overview

Our expertly curated filter lists are tailored to bolster your Pi-hole's domain blocking capabilities. Each list is focused on eliminating specific types of unwanted content, offering a more refined and efficient filtering approach:

Script Name Access Link
Adlists View
Exact Whitelist View
Exact Blacklist View
RegEx Whitelist View
RegEx Blacklist View

Getting Started

Compatibility

This collection is compatible with Pi-hole (FTLDNS) version 5 and newer.

Remote Management Tools

For managing your Pi-hole remotely, consider using one of the following SSH clients:

  • OpenSSH - A secure shell for remote management.
  • PuTTY - A popular SSH and telnet client for Windows.
  • Termius - A versatile SSH client for Android, iOS, and Desktop.

Installation

Follow these steps to apply the advanced filter collection to your Pi-hole setup:

RegEx and Exact Lists

Download and execute the installation script for RegEx and Exact Match filters:

curl -LSso pi.py https://pi.optimizethis.net
sudo python3 pi.py

Adlists

To apply the Adlists filters, download and run the corresponding script:

curl -LSso adlist.py https://adlist.optimizethis.net
sudo python3 adlist.py