tanrax/maza-ad-blocking

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

1870 stars · 73 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Maza is a local ad blocker written as a single Bash script that blocks ads at the DNS level by editing the operating system's hosts file, working like a local Pi-hole. It affects all browsers and applications without requiring extensions, and supports optional dnsmasq integration for wildcard subdomain blocking.

Use cases

• block ads in all browsers without extensions
• local pi-hole alternative for macos
• block ad domains system-wide on linux
• update ad blocking dns lists with cron
• create a local pi-hole server with dnsmasq
• whitelist or add custom blocked domains

When to choose

• you want system-wide ad blocking with zero browser extensions
• you prefer a simple single-file bash script over running a dedicated DNS server
• you use macOS, Linux, BSD, or WSL and want native tooling

When to avoid

• you need network-wide blocking for multiple devices on your LAN
• you need HTTPS-level ad filtering or cosmetic filtering like uBlock Origin
• you are on Windows without WSL

Facets

cli-tool · maturity active

security cli networking privacy privacy security self-hosted bsd cli cross-platform ad-blocking hosts-file dnsmasq pi-hole-alternative bash dns-blocking command-line macos linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tanrax/maza-ad-blocking")