Skip to content

Repository files navigation

Quiet Please - Smart Tab Muter

License Framework Website Donate

Quiet Please - Smart Tab Muter is a smart, privacy-first browser extension for Chrome, Edge, and Firefox that automatically controls tab muting based on audio output hardware (speaker vs headphones), URL whitelist/mutelist rules, context profiles, and user manual overrides.

Popup Chrome Context Popup Firefox General Hardware URLs

📦 Installation & Web Stores

Quiet Please is fully compatible with Google Chrome, Microsoft Edge, Mozilla Firefox, and other Chromium-based browsers (Brave, Vivaldi, Opera).

Get the latest extension release for your browser:

Chrome Web Store Microsoft Edge Add-ons Firefox Add-ons Official Website


🌟 Key Features

  • 🎧 Output Hardware Auto-Detection: Automatically mutes tabs when sound is routed to speakers, and keeps tabs unmuted when headphones, earbuds, or headsets are connected.
  • 🌐 URL Whitelist & Mutelist: Powerful URL pattern matching (e.g. YouTube, Google Meet, Spotify, Zoom) that can take precedence over hardware rules.
  • 🎭 Context Profiles (Environment Modes): Seamlessly switch between customized environment presets (Office, Home, Cafe, Default) with 1-click or automated timers.
  • Automated Scheduler: Set custom time-based alarms to automatically trigger context mode switches during your work day.
  • 🌐 9 Global Languages Supported: Full internationalization for English, Vietnamese, Japanese, Korean, Simplified Chinese, Traditional Chinese, French, German, and Spanish.
  • 📦 Data Backup & Restore: Export all settings and context profiles into compressed ZIP archives for offline backup or sharing.
  • 📚 Preset Catalog: Organize, edit, and bulk-import keyword and URL rules with customizable preset catalogs per context profile.
  • 🛡️ 4-Tier Decision & Priority Hierarchy:
    1. Master Switch (Silent Mode): Force mute all audio tabs browser-wide.
    2. Manual Overrides: Instant per-tab mute/unmute override directly from the extension popup.
    3. Pinned Tabs Protection: Prevent automatic muting on pinned tabs (e.g. Spotify, Slack, Meet).
    4. Configurable Priority Hierarchy: Choose whether URL Rules take priority over Hardware Rules or vice versa.
    5. Hardware Base Rule: Keyword matching against active output device labels (Chromium only).
  • 🔒 Privacy First (Zero Data Policy): 100% client-side local evaluation. No user activity, URLs, or audio data ever leave your device.
  • 🌓 Dark & Light Mode: Modern glassmorphism UI with theme support matching system preferences or manual toggle.
  • 📜 Apache 2.0 Licensed: 100% Open source with automated third-party license credit generation (CREDITS.md).

💖 Support & Donate

If Quiet Please helps protect your privacy and improves your browser audio experience, please consider supporting the ongoing open-source development!

Support & Donate


🚀 Getting Started (Development)

Prerequisites

  • Node.js >= 18
  • pnpm >= 8

Installation & Dev Server

# Install dependencies
pnpm install

# Run dev server for Chrome / Edge (Manifest V3)
pnpm dev:chrome

# Run dev server for Firefox (Manifest V3)
pnpm dev:firefox

🛠️ CLI Commands

Command Description
pnpm dev Launch Plasmo development server (default Chrome MV3)
pnpm dev:chrome Development server targeting Chrome/Edge MV3
pnpm dev:firefox Development server targeting Firefox MV3
pnpm build Production build for default target
pnpm build:chrome Production build for Chrome MV3
pnpm build:edge Production build for Edge MV3
pnpm build:firefox Production build for Firefox MV3
pnpm package:chrome Production build + auto-zip package for Chrome
pnpm package:edge Production build + auto-zip package for Edge
pnpm package:firefox Production build + auto-zip package for Firefox
pnpm fix:firefox Clean up Firefox manifest (remove offscreen permission & fix gecko ID)
pnpm lint Run ESLint static code analysis
pnpm typecheck Run TypeScript type checking (tsc --noEmit)
pnpm check Run both typecheck and lint
pnpm sync:lang Synchronize i18n translation keys across locale files
pnpm sync:credits Generate CREDITS.md from src/attributes.ts

🏗️ Project Architecture

For detailed architecture diagrams, background service worker lifecycle, and developer setup, check out our developer guides:


📄 License & Credits

  • Project Code: Licensed under Apache License 2.0.
  • Third-Party Libraries: All dependencies are permissive MIT / Apache-2.0 open source libraries.
  • Full details available in CREDITS.md.

About

Never worry about unexpected web audio leaks. Automatically mutes and unmutes tabs based on your environment, schedule, and audio devices.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages