DigitalDetox is a powerful Chrome extension that helps you break free from the endless scroll and reclaim your focus. Built with Manifest V3 for maximum performance and security.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
β π― Set daily time limits on distracting websites β
β π« Block sites completely with one click β
β πΆοΈ Prevent incognito workarounds β
β β° Get notified before your time runs out β
β π Password-protect your settings β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
Set daily usage limits for any website. When time's up, the site is blocked until tomorrow.
|
Permanently block distracting websites with zero tolerance mode.
|
|
Close the incognito loophole. When enabled, all incognito windows are automatically closed.
|
Keep your settings safe from your impulsive self.
|
When you hit your limit, you'll see a sleek, non-intrusive overlay:
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
β β° Daily limit reached β
β β
β Access will be restored tomorrow. β
β β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
| Technology | Purpose |
|---|---|
| JavaScript ES6+ | Core extension logic with modules |
| Chrome APIs | Storage, Tabs, Notifications |
| Web Crypto API | Secure password hashing |
| CSS3 | Dark theme with glassmorphism |
# Clone the repository
git clone https://github.com/Panda404NotFound/didgital_detox.git
# Navigate to chrome://extensions
# Enable "Developer mode"
# Click "Load unpacked"
# Select the "extension" folder| Language | Status |
|---|---|
| π¬π§ English | β Supported |
| π·πΊ Π ΡΡΡΠΊΠΈΠΉ | β Supported |
| πΊπ¦ Π£ΠΊΡΠ°ΡΠ½ΡΡΠΊΠ° | β Supported |
extension/
βββ π manifest.json # Extension configuration (MV3)
βββ π background.js # Service worker (timers, blocking logic)
βββ π content-script.js # Page overlay injection
βββ π pages/
β βββ dashboard.html # Settings dashboard
β βββ dashboard.css # Glassmorphism dark theme
β βββ dashboard.js # Dashboard logic
βββ π shared/
β βββ constants.js # Shared constants
β βββ crypto.js # Password hashing utilities
β βββ i18n.js # Translations (en/ru/ua)
β βββ storage.js # Chrome storage wrapper
βββ π assets/
βββ digital_detox.png # Extension icon
DigitalDetox intelligently handles subdomains:
// β
youtube.com timer catches:
// - youtube.com
// - www.youtube.com
// - m.youtube.com
// β But NOT music.youtube.com (it's a separate product!)ββββββββββββββββββββββββββββββββββββββββββββββββββ
β π Password Hashing β
β β
β Algorithm: PBKDF2-SHA256 β
β Iterations: 150,000 β
β Salt: Cryptographically random β
β Storage: Local only, never transmitted β
ββββββββββββββββββββββββββββββββββββββββββββββββββ
ββββββββββββββββ βββββββββββββββββββ ββββββββββββββββ
β Content ββββββΆβ Background ββββββΆβ Storage β
β Script β β Service Worker β β (Chrome) β
ββββββββββββββββ βββββββββββββββββββ ββββββββββββββββ
β β
β PING every 1s β Timer tracking
β (visible tabs) β Rule matching
β β Notifications
βΌ βΌ
ββββββββββββββββ βββββββββββββββββββ
β Overlay βββββββ Block Page β
β Injection β β Command β
ββββββββββββββββ βββββββββββββββββββ
- Minimal footprint: Only active on tracked websites
- Smart polling: 1s when visible, 20s when hidden
- Efficient storage: Updates batched every 3 seconds
- No memory leaks: Clean service worker lifecycle
Contributions are welcome! Feel free to:
- Fork the repository
- Create a feature branch
- Submit a pull request
