📱 userscripts

A collection of user scripts for AdGuard, TamperMonkey, and ViolentMonkey to enhance your browsing experience.

🚀 Quick Install

One-click installation: Click the button above to install the Paywall Bypass Script directly to your browser extension.

Manual installation: Download the script file and import it into your user script manager.

📚 Table of Contents

• 📱 userscripts
• 🚀 Quick Install
• 🔓 Paywall Bypass Script
  • ✨ Features
  • 📥 Installation
    • 🌐 Browser Extensions
    • 🛡️ AdGuard Extension
    • 📱 AdGuard App (Desktop/Mobile)
  • 🎮 Usage
  • 🌐 Supported Sites
• 🛠️ Scripts Directory
• 📜 License
• 🤝 Contributing
• ⚠️ Disclaimer

🔓 Paywall Bypass Script

A comprehensive user script designed to help bypass paywalls on news websites by redirecting to archive services.

✨ Features

• Floating Button Interface: Mobile and desktop-friendly floating button with dropdown menu
• Multiple Archive Services: Access to Archive.today, Archive.is, Archive.ph,Archive.org, and RemovePaywall
• Right-Click Menu Integration: Quick access through browser context menu
• Extensive Site Support: Works with hundreds of news websites including:
  • Major publications (NY Times, Washington Post, The Guardian, etc.)
  • Business news (Bloomberg, Financial Times, Wall Street Journal, etc.)
  • Tech sites (Wired, The Verge, TechCrunch, etc.)
  • Regional news outlets worldwide
• Auto Banner Removal: Automatically removes archive service banners
• Persistent Settings: Button visibility preference is saved between sessions

📥 Installation

🌐 Browser Extensions

1. Install a user script manager:
   • Tampermonkey (Chrome, Firefox, Safari, Edge, Opera)
   • Violentmonkey (Chrome, Firefox, Safari, Edge, Opera)
   • Greasemonkey (Firefox)
2. Install the script:
   • Download paywall-bypass-script.js
   • Open your user script manager
   • Import the script file

🛡️ AdGuard Extension

1. Install AdGuard Extension:
   • AdGuard for Chrome
   • AdGuard for Firefox
   • AdGuard for Safari
   • AdGuard for Edge
2. Enable User Scripts:
   • Open AdGuard settings
   • Go to “Extensions” or “User Scripts” section
   • Enable user scripts functionality
3. Install the script:
   • Option 1: Download and Import
     • Download paywall-bypass-script.js
     • In AdGuard settings, navigate to the user scripts section
     • Click “Add script” or “Import script”
     • Select the downloaded JavaScript file
     • Save the configuration
   • Option 2: Direct URL Installation
     • Copy the direct URL to the script: https://raw.githubusercontent.com/LanikSJ/userscripts/main/paywall-bypass-script.js
     • In AdGuard settings, navigate to the user scripts section
     • Click “Add script” or “Import script”
     • Choose “Install from URL” option
     • Paste the copied URL
     • Click “Install” or “Add”
     • Save the configuration
4. Verify installation:
   • Visit a supported news website
   • Look for the floating button in the bottom-right corner
   • The script should be active and functional

📱 AdGuard App (Desktop/Mobile)

1. Install AdGuard Application:
   • AdGuard for Windows
   • AdGuard for Mac
   • AdGuard for Android
   • AdGuard for iOS
2. Enable User Scripts:
   • Open AdGuard application
   • Go to Settings → Content Blocking → User Scripts
   • Enable user scripts functionality
3. Install the script:
   • Option 1: Download and Import
     • Download paywall-bypass-script.js
     • In AdGuard app, go to Settings → Content Blocking → User Scripts
     • Click “Add script” or “Import script”
     • Select the downloaded JavaScript file
     • Save the configuration
   • Option 2: Direct URL Installation
     • Copy the direct URL to the script: https://raw.githubusercontent.com/LanikSJ/userscripts/main/paywall-bypass-script.js
     • In AdGuard app, go to Settings → Content Blocking → User Scripts
     • Click “Add script” or “Import script”
     • Choose “Install from URL” option
     • Paste the copied URL
     • Click “Install” or “Add”
     • Save the configuration
4. Verify installation:
   • Visit a supported news website in your browser
   • Look for the floating button in the bottom-right corner
   • The script should be active and functional

Note: The AdGuard app works system-wide and will apply the user script to all browsers on your device, while the browser extension only works in the specific browser where it’s installed.

🎮 Usage

• Floating Button: A small button appears in the bottom-right corner of your browser
• Dropdown Menu: Click the button to reveal archive service options
• Right-Click Menu: Access archive services through your browser’s context menu
• Menu Commands: Use the user script manager’s menu to toggle the floating button

🌐 Supported Sites

The script supports paywall bypass for hundreds of news websites across the globe, including but not limited to:

• News: New York Times, Washington Post, The Guardian, BBC, CNN, etc.
• Business: Bloomberg, Financial Times, Wall Street Journal, Economist, etc.
• Tech: Wired, The Verge, TechCrunch, Ars Technica, etc.
• Regional: Sites from Australia, Europe, Asia, and the Americas

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! If you find additional sites that could be supported or have improvements to suggest, please submit a pull request.

🛠️ Scripts Directory

The /scripts/ directory contains utility tools for maintaining and validating the userscript:

domain_checker.py

A Python script that:

• Extracts all domains from the @match section of the userscript
• Validates domain accessibility by making HTTP requests
• Reports which domains are alive, offline, or timing out
• Helps identify broken or inaccessible domains in the filter list

Usage:

cd LanikSJ/userscripts/scripts
python3 domain_checker.py

run_checker.sh

A shell script wrapper that:

• Creates a Python virtual environment
• Installs required dependencies from requirements.txt
• Runs the domain checker script
• Cleans up the virtual environment after execution
• Provides a simple one-command solution for domain validation

Usage:

cd LanikSJ/userscripts/scripts
./run_checker.sh

requirements.txt

Python dependencies required for the domain validation tools:

• requests: For making HTTP requests to validate domains
• certifi, charset-normalizer, idna, urllib3: Supporting libraries for HTTP functionality

Purpose:

These scripts help maintain the quality of the userscript by:

• Identifying domains that are no longer accessible
• Ensuring the filter list remains up-to-date
• Providing automated validation before releases
• Helping contributors verify their domain additions

⚠️ Disclaimer

This script is intended for educational purposes and to access content that may be temporarily restricted. Please respect copyright and terms of service of content providers. Use at your own risk.