🚀 Instant YouTube Ad Skipper
A robust and lightweight UserScript designed to instantly bypass YouTube advertisements, delivering a seamless and uninterrupted viewing experience. This script intelligently removes video ads, banners, and popups while maintaining a low detection profile to ensure compatibility and reliability.
✨ Key Features
- Instant Ad Skipping: Automatically skips video ads, countdown timers, and survey prompts as soon as they appear.
- Comprehensive Ad Blocking: Removes banner ads, sponsored content, and premium popups across YouTube platforms.
- Efficient Detection: Utilizes
MutationObserver for real-time monitoring and swift ad removal. - Anti-Detection Measures: Incorporates randomized actions to minimize detection by YouTube’s ad systems.
- Customizable Settings: Offers flexible configuration options to tailor the script to your preferences.
- Update Notifications: Alerts you when a new version is available to keep the script optimized.
- Robust Error Handling: Ensures reliable performance with built-in retry mechanisms and mute state restoration.
🛠️ Prerequisites
To use this script, you’ll need:
- A modern web browser:
- Firefox (highly recommended)
- Google Chrome
- Microsoft Edge
- Opera
- Safari
- A UserScript manager:
📥 Installation Guide
- Install a UserScript Manager:
- Install the Script:
- Verify Installation:
- Ensure the script is enabled in your UserScript manager’s dashboard.
- Visit YouTube (
www.youtube.com, m.youtube.com, or music.youtube.com) to test ad-skipping functionality.
⚙️ Configuration Options
Customize the script’s behavior by modifying the config object within the script. Below are the available settings:
const config = { debugMode: false, // Set to true to enable detailed console logs for troubleshooting updateInterval: 24, // Hours between automatic update checks maxSkipAttempts: 3, // Maximum retry attempts for skipping stubborn ads aggressiveMode: true // Enable for enhanced ad removal (may increase detection risk) };
To modify, open the script in your UserScript manager’s editor, adjust the values, and save.
🌐 Compatibility
Supported Browsers
- Mozilla Firefox (optimal performance)
- Google Chrome
- Microsoft Edge
- Opera
- Safari
Supported Platforms
www.youtube.com (desktop)m.youtube.com (mobile)music.youtube.com (YouTube Music)
Exclusions
studio.youtube.com (YouTube Studio is not affected to avoid interfering with creator tools)
🛠️ Troubleshooting Tips
- Ads Still Appearing?
- Confirm the script is enabled in your UserScript manager.
- Refresh the YouTube page or restart your browser.
- Ensure
aggressiveMode is set to true for enhanced ad removal.
- Conflicts with Other Extensions?
- Temporarily disable other ad blockers or YouTube-related extensions to identify conflicts.
- Update Issues?
- Verify your UserScript manager is configured to allow automatic updates.
- Manually reinstall the script from the provided link if issues persist.
- Script Not Working on Mobile?
- Ensure your browser supports UserScripts (e.g., use Tampermonkey on mobile browsers like Firefox for Android).
For persistent issues, check the GitHub Issues page or open a new issue.
Make sure you enable Allow userscripts in settings Right click on Extension > Manage extension > enable Allow user scripts
🤝 Contributing
We welcome contributions to improve the script! To contribute:
- Fork the repository.
- Create a new branch for your feature or bug fix (
git checkout -b feature/new-feature). - Commit your changes and submit a pull request with a clear description.
Please follow the Code of Conduct and ensure your changes align with the script’s goals.
📜 Changelog
Version 8.0.3 (Latest)
- Improved ad detection for new YouTube ad formats
- Enhanced mute state restoration for seamless playback
- Optimized performance for mobile platforms
Version 8.0.2
- Initial public release
- Core ad-skipping functionality for videos and banners
- Basic configuration options introduced
For a full changelog, visit the GitHub Releases page.
📄 License
This script is licensed under the MIT License. You are free to use, modify, and distribute it as long as the license terms are followed.
👤 Author
Developed by Gurveer. Explore more projects at github.com/gurr-i/browser-scripts.
🙌 Support
If you find this script helpful, please:
- ⭐ Star the repository to show your support!
- 📢 Share it with others who might benefit.
- 🐞 Report issues or suggest improvements by creating a GitHub Issue.
Your feedback helps make this script better for everyone!
