Skip to content

lirena00/monochromate

Repository files navigation

Monochromate

A sleek browser extension that turns your web browsing experience into grayscale, helping reduce digital distractions and avoid doomscrolling.

Version License

Chrome Firefox

✨ 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
  • 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
pnpm install

Start the development server with:

pnpm 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:

pnpm zip
pnpm 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

Want to improve Monochromate? Contributions are always welcome!

How to Contribute

  1. Fork the repository
  2. Create a new branch: git checkout -b feature-name
  3. Make your changes
  4. Commit & push: git commit -m "Added new feature"
  5. Open a Pull Request 🎉

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ♥️ for a more focused web

About

An extension that greyscales the webpage to reduce doomscrolling

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages