Skip to content

LanikSJ/ubo-filters

πŸ›‘οΈ uBlock Origin Filters

GitHub Repo Size GitHub Code Size in Bytes GitHub Last Commit GitHub Commit Activity

πŸ“‘ Table of Contents

🎯 Purpose

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

βš™οΈ Actions

Admiral Domains Dead Domains Check Fanboy Social

πŸ“Š Coverage

Codacy Badge codecov

πŸ“„ Lists

πŸ“„ Main Lists

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:

πŸ“„ Supplemental Lists

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

πŸ”§ 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 - Filter List Processing Tool

The checksum-sort.sh script processes filter lists using FOP CLI to update date and checksum.

Basic Usage:

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

Features:

  • FOP Integration: Uses FOP CLI for sorting and checksum generation
  • Cross-Platform Compatibility: Works on both Linux and macOS
  • Simple and Fast: Minimal processing with reliable results

πŸ› οΈ 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

  • FOP.py: Filter Optimizer Python script

πŸ”„ Workflow Examples

Basic Filter Processing Workflow:

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

⚠️ Important Notes

  • All scripts use FOP CLI for processing
  • UTF-8 encoding is supported for international filter lists
  • Cross-platform compatibility ensures consistent behavior on Linux and macOS

❓ FAQ

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.

πŸ™Œ Attributions

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

πŸ› Bugs

Please report any bugs or issues you find. Thanks!

πŸ“ License

MIT License

πŸ’° Donate

Patreon