Monochromate
An extension that greyscales the webpage to reduce doomscrolling
Install / Use
/learn @lirena00/MonochromateREADME
Monochromate
A sleek browser extension that turns your web browsing experience into grayscale, helping reduce digital distractions and avoid doomscrolling.
✨ Features
- One-Click Toggle - Instantly switch between color and grayscale modes
- Intensity Control - Fine-tune the grayscale effect (0-100%)
- Site Exclusions - Maintain a blacklist of sites where color should remain enabled
- Site Inclusions - Maintain a whitelist of sites where greyscale should be enabled
- Smart Scheduling - Automatically enable/disable monochrome mode at specific times
- Real-time Updates - Changes apply instantly without page refresh
- Backup & Restore - Export and import your settings configuration
- Current Site Management - Quick add/remove current website to exclusions
- Fullscreen Support - Seamlessly works with fullscreen content and videos
- Search & Filter - Easily find and manage excluded sites with search functionality
- Minimal Interface - Clean, modern UI with intuitive controls
- Temporary Disable - Disable extension for specific period of time then re-enable it automatically
- Media-only page exclusion - Media only page can be excluded
- Shortcut keys - Shortcut keys for several actions to access them swiftly
🛠️ Development
Setup & Run
Clone the repository and install dependencies:
git clone https://github.com/your-username/monochromate.git
cd monochromate
bun install
Start the development server with:
bun dev
This will build the extension in watch mode, so changes automatically reflect when reloaded in the browser.
Building for Production
To generate an optimized build:
bun zip
bun zip:firefox
This creates a final version inside the dist/ folder, ready for submission to the Chrome Web Store and Mozilla Add-ons.
for more detailed installation visit WXT Guide
🤝 Contributing
Read the CONTIBUTING.md file for details
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
<div align="center"> Made with ♥️ for a more focused web </div>