Skip to content

ammnt/DeadEnd

DeadEnd sign logo

CI/CD Version GitHub stars GitHub stars GitHub issues open Open Source Maintained


Description

This repository contains an enhanced DNS filter designed specifically for AdGuard Home. The filter.txt file provides comprehensive blocking of various unwanted domains and their subdomains, including:

  • Advertising, CPA, and banner networks πŸ’©
  • Tracking and telemetry services πŸ“‘
  • CNAME cloaking techniques, analytics, and metrics collection πŸ•΅οΈ
  • Chat widgets, cookie consent, and push notification services πŸ”•
  • Selected adware, spyware, and malware domains 🀬

You are free to use this filter in any way you see fit. The list is regularly updated and maintained to ensure ongoing effectiveness πŸš€

Repository structure

DeadEnd/
β”œβ”€β”€ πŸ€– AGENTS.md                         # AI agent instructions and project context
β”œβ”€β”€ 🀝 CODE_OF_CONDUCT.md                # Code of conduct for contributors
β”œβ”€β”€ βš™οΈ configuration.json                # Build configuration and external source lists
β”œβ”€β”€ πŸ’» CONTRIBUTING.md                   # Contributing guidelines
β”œβ”€β”€ πŸ“ .editorconfig                     # EditorConfig for consistent coding styles
β”œβ”€β”€ βœ… exclusions.txt                    # Explicit domains to never block (false positives)
β”œβ”€β”€ 🧹 filter.txt                        # Auto-generated blocklist for AdGuard Home
β”œβ”€β”€ πŸ”§ .gitattributes                    # Git attributes for language detection
β”œβ”€β”€ πŸ—‚οΈ .github/                          # GitHub-specific configuration
β”‚   β”œβ”€β”€ πŸ€– dependabot.yml                # Automated dependency update rules
β”‚   β”œβ”€β”€ πŸ“‹ ISSUE_TEMPLATE/               # Issue creation templates
β”‚   β”‚   β”œβ”€β”€ πŸ› bug_report.md             # False positive/negative or bug report
β”‚   β”‚   β”œβ”€β”€ βš™οΈ config.yml                # Issue templates configuration
β”‚   β”‚   └── πŸ’‘ feature_request.md        # New feature or domain source request
β”‚   β”œβ”€β”€ πŸ”€ PULL_REQUEST_TEMPLATE.md      # Pull request checklist and template
β”‚   └── πŸ”„ workflows/                    # GitHub Actions CI/CD pipelines
β”‚       β”œβ”€β”€ πŸ”¨ build.yml                 # Scheduled filter building and testing
β”‚       └── πŸ”’ codeql.yml                # CodeQL static security analysis
β”œβ”€β”€ πŸ™ˆ .gitignore                        # Git ignore rules
β”œβ”€β”€ βž• inclusions.txt                    # Explicit domains to block (manual additions)
β”œβ”€β”€ βš–οΈ LICENSE                           # MIT License agreement
β”œβ”€β”€ 🎨 logo.png                          # Project logo and branding
β”œβ”€β”€ πŸ“¦ package.json                      # Node.js dependencies and build scripts
β”œβ”€β”€ πŸ“– README.md                         # Main project documentation
β”œβ”€β”€ πŸ”’ SECURITY.md                       # Security policy and vulnerability reporting
└── 🧢 yarn.lock                         # Yarn dependency lock file

Note

This filter is specifically optimized for use ONLY with AdGuard Home πŸ›‘οΈ If you encounter any false positives or would like to suggest additional domains for blocking, please feel free to open a new Issue πŸ™‹