🛡️ Simple YouTube Ad Blocker

Because life's too short to watch "Skip Ad in 5...4...3..." for the 42nd time today

Features • Installation • How It Works • Contributing • Support

Clean, simple UI that sparks joy ✨

---

🎭 What's This?

A sophisticated Chrome extension that makes YouTube ads disappear faster than your productivity during a cat video marathon. Built with modern JavaScript and a UI so clean it would make Marie Kondo proud.

✨ Features

🎯 Video Ad Assassination Terminates those pesky mid-video ads faster than you can say "but wait, there's more!" 🚫 Banner Begone Removes banner ads, overlays, and promotional content like your ex from your Instagram feed 📊 Stats That Matter Tracks how many ads you've blocked, because who doesn't love watching numbers go up?

⚡ Lightning Fast Blocks ads faster than your friend's "quick" 5-minute story 🎨 Eye Candy UI So pretty, you'll want to block ads just to see the popup again

🚀 Installation

From Chrome Web Store

"Want it from the Chrome Web Store? Well..."

Me: checks wallet 🔍
Wallet: laughs in empty 😂
Chrome Store: "That'll be $5" 🤑
Me: "Best I can do is manual installation" 💁‍♂️

Manual Installation (The Free Way™)

1. Clone this repo (or download it, we don't judge)

git clone https://github.com/sh13y/youtube-ad-blocker.git

2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" (top-right corner, like your notification badges)
4. Click "Load unpacked" and select the extension directory
5. Enjoy YouTube like it's premium (except it's free... shhh! 🤫)

🛠️ How It Works

This extension works harder than a caffeinated squirrel on a sugar rush:

• Background Script: The vigilant guardian that never sleeps (unlike your regular sleep schedule)
• Content Script: The ninja that swiftly removes ads before you even notice them
• Popup UI: The pretty face of the operation, showing you all the stats you never knew you needed

🎯 Technical Features

• Modern JavaScript ES6+ (because we're not cavemen)
• Chrome Extension Manifest V3 (because V2 is so 2020)
• Clean Architecture (cleaner than your room probably)
• Efficient Ad Detection (faster than your cat's reflexes)
• Persistent Statistics (unlike your New Year's resolutions)

🤝 Contributing

Found a bug? Want to add a feature? Have a better joke for this README?

1. Fork it (like a boss)
2. Create your feature branch:

git checkout -b feature/AmazingFeature

3. Commit your changes:

git commit -m 'Add some AmazingFeature'

4. Push to the branch:

git push origin feature/AmazingFeature

5. Open a Pull Request (and maybe include a meme)

⚠️ Disclaimer

This extension was created for educational purposes only. Please support content creators you love! (But maybe not the ones who put 5 ads in a 3-minute video... just kidding! Or are we? 🤔)

🎮 Usage Tips

• 💡 Toggle On/Off: Like your ex's Instagram notifications
• 📈 Watch Stats Grow: More satisfying than bubble wrap
• 🎥 Video Ads: Gone faster than your weekend
• 🎯 Banner Ads: Vanish quicker than your motivation on Monday morning

📜 License

MIT License - Feel free to use it, just don't blame us if YouTube gets mad!

🙏 Credits

• Built with love, caffeine, and a slight vendetta against mid-video ads
• Powered by the collective frustration of YouTube users worldwide
• Special thanks to Stack Overflow (our true MVP)
• Dedicated to everyone who's ever rage-clicked a "Skip Ad" button

💖 Support

If this project helped you skip an ad, consider:

• Giving it a ⭐️ (it's free, just like YouTube should be!)
• Sharing it with friends (spread the joy of ad-free viewing)
• Buying me a coffee (because debugging requires fuel) ☕

---

Made with 💻 by developers who got tired of reaching for the "Skip Ad" button while eating snacks

Remember: Time saved from ads = More time for cat videos 😺