maza-ad-blockingSimple, native and efficient local ad blocker. Only Bash.

maza-ad-blocking

Maza is a lightweight, bash-only ad blocker that works locally on your system to block ads across all browsers and applications. Unlike browser extensions, it operates at the OS level using native tools, providing system-wide ad blocking with minimal overhead.

Key Features

• Bash-only implementation: Requires only bash 4.0 and curl—no complex dependencies or applications to install
• System-wide blocking: Blocks ads in all browsers and software simultaneously by modifying DNS resolution
• Cross-platform support: Works on macOS, Linux, BSD, and Windows Subsystem for Linux (WSL)
• Easy management: Single commands to start, stop, update, and check blocking status
• Customizable filtering: Whitelist specific domains, add custom domains to block, or swap DNS blocklists

Use Cases

• Home network protection: Block ads across all devices by configuring dnsmasq as a local DNS server
• Privacy-focused browsing: Eliminate ads and trackers at the DNS level without browser extensions
• Lightweight systems: Run on resource-constrained devices like Raspberry Pi or VPS with minimal impact
• System administrators: Deploy consistent ad blocking policies across multiple machines

Who Is It For

Maza is ideal for users seeking a simple, dependency-free ad blocking solution that works system-wide without installing extensions or applications. It appeals to privacy-conscious users, system administrators, and anyone running resource-limited hardware who wants native ad blocking.