View on GitHub

Web Annoyances

Web Annoyances List for AdGuard and uBlock Origin

Download this project as a .zip file Download this project as a tar.gz file

🛡️ Web Annoyances Ultralist - unsuck the web!

📑 Table of Contents

📖 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 2025 Before Installing Web Annoyances Ultralist

scrolling_video_newsletter_header_share_icons highlighted

Above screenshot taken using uBlock Origin Default Filter Lists

🟩 After

Typical Website in 2025 After Installing Web Annoyances Ultralist

afterinstall

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 uBO_icon_16 uBlock Origin, adguard_icon_16 AdGuard for 64px-Windows_darkblue_2012_svg svg, or adguard_icon_16 AdGuard for 64px-MacOS_wordmark_(2017) svg.

Browser specific download locations are located below:

💻 Desktop

📱 Mobile

⚡ 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:

installpopup

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.

installed

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:

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:

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:

🛠️ Other Utility Scripts

Domain-Specific Processing Scripts

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

Additional Tools

📋 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:

🔄 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

💬 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.