🛡️ Web Annoyances Ultralist - unsuck the web!

📑 Table of Contents

• 📖 Intro
• 🎬 Demonstration
  • 🟥 Before
  • 🟩 After
• 🔧 Requirements
  • 💻 Desktop
  • 📱 Mobile
• ⚡ One Click Installation
  • 📝 Installation Notes
• 🔧 Usage Instructions
  • 📝 Filter Processing Scripts
  • 🛠️ Other Utility Scripts
  • 📋 Configuration
  • 🔄 Workflow Examples
• 💬 EasyList Forum
• 🌐 Mirror Hosts of Web Annoyances Ultralist
• 📄 License

📖 Intro

Are you tired of not being able to use all of your screen real estate for the text that matters on a website because floating headers and other distracting elements are blocking your view? Reclaim your screen real estate with Web Annoyances Ultralist!

Block annoying web elements such as sticky headers, dickbars, floating headers, scrolling headers, fixed headers, scrolling videos, stickynavs, social icons, social share bars, smartphone app banners, app download prompts, cookie notices, GDPR warnings, scroll to top buttons, modal overlays, interstitial site overlays, removed or hidden overflow scroll bars, subscription nags, and generally distracting elements that have increasingly been turning the web into a user-hostile environment.

When possible, sticky headers, stickynavs, floating elements, scrolling videos and more will be pinned in place to prevent site breakage.

🎬 Demonstration

🟥 Before

Typical Website in 2020 Before Installing Web Annoyances Ultralist

Above screenshot taken using uBlock Origin Default Filter Lists

🟩 After

Typical Website in 2020 After Installing Web Annoyances Ultralist

Above screenshot taken using uBlock Origin Default Filter Lists + Web Annoyances Ultralist

Head over to the demonstration page for additional visual examples of Web Annoyances Ultralist in action.

🔧 Requirements

This filter list aims to remove annoying web elements that block your view of the screen and is created and optimized using the uBlock Origin Extended Syntax.

For the best user experience, please use this filter list with uBlock Origin, AdGuard for , or AdGuard for .

Browser specific download locations are located below:

💻 Desktop

• uBlock Origin for Google Chrome
• uBlock Origin for Mozilla FireFox
• uBlock Origin for Apple Safari
• uBlock Origin for Opera
• AdGuard for
• AdGuard for

📱 Mobile

• uBlock Origin for Mozilla FireFox for Android
• uBlock Origin for Kiwi Browser for Android

⚡ One Click Installation

Click the following: Add Web Annoyances Ultralist to Custom uBlock Origin Filters.

📝 Installation Notes

After clicking the Link above, a warning box will appear asking you to confirm the installation - Click 'OK' to add the list to your Custom Filter Lists.

The warning box will look like the following:

After clicking 'OK' the filter list should be installed.

You can validate the list installed properly by navigating to your uBlock Origin Dashboard and clicking on the Filter lists tab. Scroll to the bottom of the screen and verify Web Annoyances Ultralist is showing up in your custom section.

Step-by-Step install instructions are available in the wiki.

🔧 Usage Instructions

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

📝 Filter Processing Scripts

checksum-sort.sh - Enhanced Backup & Sorting Tool

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

Basic Usage:

./scripts/checksum-sort.sh filters/ultralist.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/ultralist.txt

# View backup history
ls -la backup/

Sample Output:

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

sorter.pl - Enhanced Fanboy Adblock Sorter v2.0

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/ultralist.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/ultralist.txt

# Custom backup suffix
perl scripts/sorter.pl --backup-suffix .original filters/ultralist.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/ultralist.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

🛠️ Other Utility Scripts

Domain-Specific Processing Scripts

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

Additional Tools

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

📋 Configuration

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

🔄 Workflow Examples

Basic Filter Processing Workflow:

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

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

# 3. If needed, manually sort with verbose output
perl scripts/sorter.pl --verbose filters/ultralist.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

⚠️ Important Notes

• 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

💬 EasyList Forum

Join the EasyList Forum @ https://forums.lanik.us for faster reporting of issues and chat.

🌐 Mirror Hosts of Web Annoyances Ultralist

TBD

📄 License

This project is licensed under the MIT License.