🎮 Dr. DOM - The Privacy Extension That Actually Works

🕵️ Real-time tracker detection • 🔥 Honest site roasts • 🎯 Live privacy scoring

Install Extension • Features • Demo • Contributing

---

🚀 What is Dr. DOM?

Dr. DOM is a privacy-focused Chrome extension that detects trackers, analyzes cookies, and roasts websites based on their actual privacy practices. Unlike other extensions, we use 100% real data with a touch of humor to make privacy awareness engaging.

✨ Core Features

🎯 Live Tracker Display

• Real-time monitoring widget showing:
  • 🍪 Cookie count
  • 🎯 Active trackers
  • 👁️ Tracking pixels
  • 📊 Privacy score (0-100)
• Minimizable floating widget
• Updates every second with live data

🔥 Honest Site Reviews

• Brutally honest roasts based on real metrics:
  • 50+ trackers: "This site has more stalkers than a celebrity!"
  • 50+ cookies: "That's not a website, it's a bakery!"
  • No HTTPS: "Like leaving your door open with a 'Rob Me' sign!"
• Trust score calculation (0-100)
• Detailed breakdown of privacy issues
• Site-specific roasts for major platforms

🌤️ Privacy Weather Report

• Creative weather metaphors for privacy status:
  • ☀️ HOT - Clear Privacy Skies (90-100 score)
  • ⛅ WARM - Partly Tracked (70-89)
  • ☁️ COOL - Overcast with Cookies (50-69)
  • 🌧️ COLD - Privacy Storm Warning (30-49)
  • ⛈️ FREEZING - CATASTROPHIC DATA LEAKAGE! (0-29)

🛡️ Advanced Detection

• 30+ tracker networks detected (Google, Facebook, Amazon, etc.)
• Fingerprinting detection (Canvas, WebGL, Audio)
• Malware checking with whitelisting for major sites
• GDPR/CCPA compliance checking
• SSL/Security analysis

🎭 Fun Privacy Banner

• Humorous messages about blocking trackers
• Random roasts and privacy jokes
• Auto-dismisses after 10 seconds
• Beautiful gradient design with Dr. DOM logo

📦 Installation

Option 1: Download Pre-built Release (Easiest)

1. Download the latest release from Releases page
2. Unzip dr-dom-extension-v2.0.0.zip
3. Open Chrome → chrome://extensions/
4. Enable "Developer mode"
5. Click "Load unpacked" → Select the unzipped folder

Option 2: Build from Source

1. Clone the repository:

git clone https://github.com/humancto/dr-dom.git
cd dr-dom

2. Load in Chrome:

   • Open chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked"
   • Select the dist/chrome folder

3. That's it! Visit any website and watch Dr. DOM work its magic.

🎮 How It Works

1. Automatic Detection: Extension activates on every website
2. Real-time Monitoring: Live tracker widget appears in top-right
3. Click Extension Icon: Access detailed privacy report with multiple tabs
4. Get Roasted: Sites with poor privacy practices get brutally honest feedback

📊 What We Actually Track

Category	What We Detect	How We Show It
Trackers	Google Analytics, Facebook Pixel, 30+ networks	Live counter + company names
Cookies	All browser cookies, third-party tracking	Real-time count + analysis
Pixels	1x1 tracking pixels, beacons	Hidden pixel detection
Security	HTTPS status, mixed content	Security score + warnings
Fingerprinting	Canvas, WebGL, Audio attempts	Detection + protection options

🎯 Demo

Visit these sites with Dr. DOM installed to see it in action:

• News sites: Watch tracker counts explode
• Social media: See fingerprinting attempts
• Shopping sites: Cookie bonanza
• Privacy-focused sites: Get rare good scores!

⚡ Performance

• Lightweight: ~30MB memory footprint
• Fast: <200ms page load impact
• Local: No external API calls
• Efficient: Optimized detection algorithms

🛠️ Technical Stack

• Manifest V3 Chrome Extension
• Pure JavaScript (No frameworks needed!)
• Chrome Storage API for data persistence
• Real-time DOM monitoring with MutationObserver
• Performance API for timing metrics

🚀 Creating a Release (For Maintainers)

Package the Extension

# Make the script executable (first time only)
chmod +x package-extension.sh

# Run the packaging script
./package-extension.sh

# This creates: dist/dr-dom-extension-v2.0.0.zip

Create GitHub Release

1. Package the extension using the script above
2. Go to GitHub Releases
3. Click "Create a new release"
4. Tag version: v2.0.0
5. Release title: Dr. DOM v2.0.0 - Privacy Extension
6. Upload the zip file from dist/
7. Add release notes from RELEASES.md
8. Publish release

Alternative Packaging Scripts

# With URLhaus database
./scripts/package-with-database.sh

# Using Node.js build system
node build.js --package

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Report Bugs: Open an issue with details
2. Add Trackers: Help us detect more tracking networks
3. Improve Roasts: Submit funnier, more savage roasts
4. Enhance Detection: Improve our algorithms
5. Documentation: Help others understand privacy better

📜 License

MIT License - Free to use, modify, and distribute. See LICENSE file.

🙏 Acknowledgments

• Privacy Community for tracker detection patterns
• Open Source Contributors for making this possible
• You for caring about your privacy!

📞 Contact & Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Twitter: @drdom_extension

---

🔥 Why Dr. DOM?

"Because your privacy shouldn't be a joke, but learning about it can be fun!"

Real Detection • Honest Feedback • Zero BS

⬆ Back to top