Skip to content

electro0nes/wayback-cdx-filter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wayback CDX Domain Filter Extension

Overview

This is a simple browser extension that allows bug hunters and users to filter out unwanted domains or subdomains directly on the Wayback Machine CDX results page. The Wayback Machine itself does not support excluding specific subdomains, so this extension injects a user-friendly filter UI to hide matching results without modifying the original data. Note: This version is primarily designed and tested for Google Chrome. For Firefox compatibility, the extension uses the WebExtensions API (Manifest V3), which is cross-browser compatible. However, you may need to make minor adjustments, such as testing in Firefox Developer Edition and submitting to the Mozilla Add-ons store. No major code changes are required, but ensure that any Chrome-specific permissions or behaviors (e.g., chrome://extensions/) are handled generically.

Features

  • Adds a compact filter box above the CDX results.
  • Enter unwanted domains/subdomains (one per line) in a textarea.
  • Apply filter to hide matching URLs in the results.
  • Reset button to restore original results.
  • Works on pages like https://web.archive.org/cdx/search/cdx? ...
  • Simple and lightweight – no external dependencies.

Installation

  1. Clone the repository:

git clone https://github.com/electro0nes/wayback-cdx-filter.git

  1. For Chrome:

    • Go to chrome://extensions/
    • Enable "Developer mode".
    • Click "Load unpacked" and select the cloned folder.
  2. For Firefox:

    • Go to about:debugging#/runtime/this-firefox
    • Click "Load Temporary Add-on..." and select the manifest.json file from the cloned folder.
    • For permanent installation, zip the folder and submit to Mozilla Add-ons (ensure Manifest V3 compatibility).

Usage

  1. Navigate to a Wayback Machine CDX search page (e.g., https://web.archive.org/cdx/search/cdx?url=*.example.com/*&fl=original&collapse=urlkey&page=).
  2. Wait to load all URLs, The filter UI will appear above the results.
  3. Enter unwanted domains in the textarea (e.g., sub.example.com on one line, another.com on the next).
  4. Click "Apply Filter" to hide matching lines.
  5. Click "Reset" to restore the original results.
  6. Tip: Use Ctrl + Enter in the textarea for quick filtering.

Credits

  • This extension was created by Moein Erfanian (electro0ne).

License

MIT License - Feel free to modify and distribute.