• 🎯 Purpose
• ⚙️ Actions
• 📊 Coverage
• 📄 Lists
  • 📄 Main Lists
  • 📄 Supplemental Lists
• 🔧 Usage Instructions
  • 📝 Filter Processing Scripts
  • 🛠️ Other Utility Scripts
  • 📋 Configuration
  • 🔄 Workflow Examples
• ❓ FAQ
• 🙌 Attributions
• 🐛 Bugs
• 📝 License
• 💰 Donate

I got tired of losing my filters when I switched machines so I created this repo.

If you'd like to use any of the filter lists in this repo click the bellow links for AdBlock / AdBlock Plus / AdGuard / uBlock Origin:

• AdMaven Domains Filter List
• AdMeasures Domains Filter List
• BT Contentza Domains Filter List
• CDN Domains Filter List
• Combined Ad Domains Filter List
• Cryptomining Domains Filter List
• Fanboy Social No Cosmetic Filter List
• Free Counter Stat Domains Filter List
• GetAdmiral Domains Filter List
• Hilltop Ads Domains Filter List
• iStripper Domains Filter List
• Kitty Domains Filter List
• Lanik uBO Filters List
• MacUpload Domains Filter List
• Malware Domains (Long Lived)
• PopAds Domains Filter List
• PropellerAds Domains Filter List
• TOR Advertising Domains Filter List
• uBlock Filters Plus List
• VideoAdex Domains Filter List
• VolumeData Domains Filter List

Some of these are old lists or not working lists for archiving purposes:

• Adblock Warning Removal List
• AdGuard DNS Filter
• Block Everything
• Fake-News List
• Fuck Fuckadblock Mining
• I Don't Care About Cookies
• Malware Domains Long-Lived
• Malware Filter by Disconnect
• NoCoin Filter List
• Prebake - Filter Obtrusive Cookie Notices
• PUP Domains Blocklists
• uBlock Filters Plus

This repository includes several scripts for managing and processing filter lists. Below are the usage instructions for the main tools.

The checksum-sort.sh script provides comprehensive filter list processing with advanced backup functionality.

Basic Usage:

./scripts/checksum-sort.sh filters/combined-filters.txt

Features:

• Organized Backup Storage: Centralized backup directory (backup/) for better organization
• Backup Integrity Verification: Automatic checksum verification using SHA256, MD5, or size comparison
• Automatic Backup Rotation: Configurable maximum backup retention (default: 10 backups)
• Enhanced Error Handling: Robust rollback mechanism with verification
• Cross-Platform Compatibility: Works on both Linux and macOS

Advanced Usage:

# List available backups for a filter file
./scripts/checksum-sort.sh --list-backups filters/combined-filters.txt

# View backup history
ls -la backup/

Sample Output:

[INFO] 2024-01-15 10:30:15 Available backups for 'combined-filters.txt':
-rw-r--r-- 1 user staff 1.2M Jan 15 10:25 combined-filters.txt.backup.20240115_102530
-rw-r--r-- 1 user staff 1.1M Jan 15 09:15 combined-filters.txt.backup.20240115_091545

The sorter.pl script has been completely rewritten with modern Perl best practices and enhanced functionality.

Basic Usage (Backward Compatible):

perl scripts/sorter.pl filters/combined-filters.txt

Command Line Options:

• --help, -h: Show comprehensive help
• --verbose, -v: Enable detailed logging
• --backup-suffix: Customize backup file suffix
• --no-backup: Skip backup creation
• --dry-run: Preview changes without modification

Advanced Usage Examples:

# Verbose processing with detailed statistics
perl scripts/sorter.pl --verbose filters/combined-filters.txt

# Custom backup suffix
perl scripts/sorter.pl --backup-suffix .original filters/combined-filters.txt

# Process multiple files without backups
perl scripts/sorter.pl --no-backup filters/*.txt

# Preview changes without making modifications
perl scripts/sorter.pl --dry-run --verbose filters/combined-filters.txt

Features:

• Modern Perl Standards: Strict and warnings pragmas, UTF-8 support
• Enhanced Error Handling: Comprehensive file validation and graceful error recovery
• Statistics and Monitoring: File statistics, section counting, before/after comparison
• Multi-file Support: Process multiple files with individual error handling
• Safety Features: Atomic file operations, configurable backups, proper cleanup

The repository includes several specialized scripts for processing different types of filter lists:

• admiral-domains.sh: Process Admiral anti-adblock domains
• combined-filters.sh: Generate combined filter lists
• fanboy-social.sh: Process Fanboy social media filters
• malware-domains.sh: Process malware domain lists
• remove-lines.sh: Remove specific lines from filter lists

• addChecksum.pl: Add checksums to filter lists
• FOP.py: Filter Optimizer Python script

Backup Configuration (checksum-sort.sh):

readonly BACKUP_DIR="${SCRIPT_DIR}/../backup"  # Backup storage location
readonly MAX_BACKUPS=10                        # Maximum backups to retain

Customization Options:

• Modify BACKUP_DIR to change backup location
• Adjust MAX_BACKUPS to change retention policy
• Logging format can be customized in log functions

Basic Filter Processing Workflow:

# 1. Process and sort a filter list with backup
./scripts/checksum-sort.sh filters/combined-filters.txt

# 2. Check processing results
./scripts/checksum-sort.sh --list-backups filters/combined-filters.txt

# 3. If needed, manually sort with verbose output
perl scripts/sorter.pl --verbose filters/combined-filters.txt

Development Workflow:

# 1. Test changes without modification
perl scripts/sorter.pl --dry-run --verbose filters/test-filter.txt

# 2. Apply changes with custom backup
perl scripts/sorter.pl --backup-suffix .dev filters/test-filter.txt

# 3. Process with full backup and verification
./scripts/checksum-sort.sh filters/test-filter.txt

• All scripts maintain backward compatibility with existing workflows
• Backup files are automatically managed and rotated
• UTF-8 encoding is supported for international filter lists
• Cross-platform compatibility ensures consistent behavior on Linux and macOS
• Process-safe temporary files prevent conflicts during concurrent operations

Q: Will these filter lists support any other adblockers such as AdGuard etc?

A: Yes, some of these lists do work with AdGuard, but USE AT YOUR OWN RISK as they haven't been tested thoroughly yet.

Some scripts have been "borrowed" from Fanboy ©️ All rights reserved by the original authors.

Please report any bugs or issues you find. Thanks!