A simple, native, and efficient local ad blocker written entirely in Bash, working across all browsers without extensions.
Maza is a local ad blocker that blocks ads at the system level by updating the hosts file with known advertising domains. It functions like a local Pi-hole, preventing ads from loading in any browser or application without requiring browser extensions. The tool is written entirely in Bash and works across multiple operating systems.
System administrators, developers, and privacy-conscious users who want a lightweight, command-line ad blocker that works system-wide without installing browser extensions or complex software.
Developers choose Maza for its simplicity, transparency, and efficiency—it's a single Bash script with no external dependencies, offers cross-platform compatibility, and provides system-wide ad blocking without the overhead of a full network solution.
Simple, native and efficient local ad blocker. Only Bash.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Blocks ads in any browser or application by modifying the hosts file, eliminating the need for individual extensions, as shown in the demo.
Works on macOS, Linux, BSD, and WSL with just Bash and curl, making it lightweight and dependency-free.
Supports custom domains and alternative sources like Steven Black's hosts, allowing tailored ad blocking via config files.
Pure Bash script is easy to audit and understand, emphasizing open-source transparency without bloat.
The hosts file method cannot block sub-domains without complex DNSMASQ integration, which requires additional setup and configuration.
Needs sudo to modify system files, posing potential security risks and incompatibility with locked-down or shared systems.
Automatic updates rely on cron jobs, with macOS users needing to handle PATH issues, adding maintenance complexity.