Contents

ZeroDot1s Whitelist Generator

Version 1.8.7

A professional, free, and open source client-side tool for generating optimized firewall whitelists and DNS allowlists.

What is ZD1-WLG?

I created this tool to make it easier to quickly generate custom firewall whitelists. While pre-made whitelists exist, they are never as precise as the ones you tailor yourself; this tool serves as a simple helper to bridge that gap.

ZeroDot1s Whitelist Generator (ZD1-WLG) is a specialized utility designed for network security administrators and enthusiasts. It bridges the gap between raw domain lists and ready-to-use firewall configurations.

Whether you are securing an enterprise FortiGate firewall, a home pfSense appliance, or a Pi-hole DNS sinkhole, this tool streamlines the whitelist creation process while maintaining absolute privacy.

How It Works

ZD1-WLG operates on a "Zero-Trust" data model regarding your input:

1. Pure Client-Side Logic

The application is written in vanilla JavaScript. Every regular expression, parser, and formatter runs within your own browser's sandbox. No data leaves your machine.

2. Intelligent Parsing

The parser handles messy text, extracts domains from URLs, respects comments, and automatically handles wildcard formats across multiple lines.

3. Optimized Export

The tool doesn't just copy-paste; it formats the output according to the specific best practices of the target system (e.g., using address groups for FortiGate).

Key Features

Privacy First

All processing happens in your browser. No data is ever uploaded to external servers. Your domain lists remain private.

No Installation

Works directly in your browser. No plugins, no software to install, no dependencies to manage.

Multi-Format Export

Generate configurations for FortiGate, pfSense, Pi-hole, Sophos, AdGuard Home, Unbound, Dnsmasq, Suricata, and more.

Preset System

Built-in presets for popular services like SwitchBot, smart routers, and cloud services. Easily add your own custom presets.

Deep Search

Search presets by name, description, or content. Find domains across multiple presets instantly.

Smart Wildcards

Input wildcards as .example.com or *.example.com. The tool converts them correctly for each target system.

Technology

ZD1-WLG is built with modern web technologies and requires no server-side processing:

  • HTML5 - Semantic markup and accessibility
  • CSS3 - Custom properties for theming, responsive design
  • JavaScript (ES2020+) - Modern JS with const/let, arrow functions, async/await, optional chaining
  • No frameworks - Lightweight and fast

Browser Support

The generator supports all modern browsers:

  • Chrome 80+
  • Firefox 75+
  • Safari 13.1+
  • Edge 80+

Architecture

The application uses a modular JavaScript architecture:

  • app.js - Main application entry point and wizard logic
  • modules/parser.js - Domain extraction from mixed text
  • modules/exporter.js - Export format generation (11 formats)
  • modules/ui.js - UI component creation
  • modules/state.js - Application state management
  • modules/config.js - Configuration and constants

Build System

The build.js script handles:

  • Presets manifest generation from WLS/ directory
  • File integrity manifest with SHA-256 hashes
  • Version syncing across all HTML files
  • Domain validation for each preset

Run node build.js after adding new presets.

Get Started

Open Generator Read Documentation GitLab Repository

License

GNU Affero General Public License v3.0 (AGPL-3.0)

ZeroDot1s Whitelist Generator is open source software released under the AGPL-3.0 License. You are free to use, modify, and distribute this project, provided you include the original copyright notice.

See the LICENSE file for full terms.