ChatGard is a browser extension that blurs chat lists and messages until hovered to prevent shoulder surfing in public and office environments. Built for WhatsApp Web and Telegram Web A (web.telegram.org/a/) with planned support for additional web messengers.
- Hover to reveal: Blurs chat list items and message bodies by default and reveals content when hovered or focused.
- Configurable popup: Toggle protection on/off, adjust blur intensity, and selectively choose which elements to blur (entire row, last message preview, contact names, avatars, active chat window).
- Supported platforms: Full privacy blur support on WhatsApp Web (
web.whatsapp.com) and Telegram Web A (web.telegram.org/a/*). - Local-first: No remote requests, no telemetry, and operates strictly on client DOM.
Download the pre-built zip file for your browser from the latest GitHub Releases.
- Download the
chatgard-*-chrome.ziparchive from the release assets and extract it to a folder. - Open your browser's extensions page:
- Chrome:
chrome://extensions - Brave:
brave://extensions - Edge:
edge://extensions
- Chrome:
- Toggle Developer mode on (in the top-right corner).
- Click Load unpacked and select the extracted folder.
- Open WhatsApp Web or Telegram Web A to use ChatGard.
- Download the
chatgard-*-firefox.ziparchive from the release assets and extract it to a folder. - Open
about:debugging#/runtime/this-firefoxin Firefox. - Click Load Temporary Add-on....
- Select the
manifest.jsonfile inside the extracted folder. - Open WhatsApp Web or Telegram Web A.
Note
In standard Firefox, temporary add-ons stay loaded until the browser restarts. Firefox support is experimental and has not been comprehensively validated on live WhatsApp Web or Telegram Web yet.
- Bun (v1.0+)
Install project dependencies:
bun installStart the development server:
bun run dev # Chromium (default)
bun run dev:firefox # FirefoxBuild production packages:
bun run build # Chromium (.output/chrome-mv3)
bun run build:firefox # Firefox (.output/firefox-mv2)Create distributable zip files:
bun run zip # Chromium zip (.output/chatgard-*-chrome.zip)
bun run zip:firefox # Firefox zip (.output/chatgard-*-firefox.zip)Run tests:
bun testRun TypeScript type checking:
bun run compile- Chromium-based browsers: Open
chrome://extensions, enable Developer mode, click Load unpacked, and select.output/chrome-mv3. - Firefox: Open
about:debugging#/runtime/this-firefox, click Load Temporary Add-on..., and select.output/firefox-mv2/manifest.json.
- Chromium-based browsers (Chrome, Brave, Edge): Supported and tested.
- Firefox: Experimental / Not fully tested yet (Manifest V2 build available via
bun run build:firefox).
ChatGard is designed from the ground up with a strict privacy-first architecture:
- 100% Client-Side: All blurring and hover-to-reveal effects occur entirely in your browser via local CSS injection and DOM mutations.
- Zero Telemetry & Analytics: No tracking pixels, remote server requests, telemetry, or external network calls of any kind.
- Local Storage Only: User preferences (such as blur intensity and section toggles) are saved strictly on your local device using standard extension storage (
chrome.storage.local/browser.storage.local). - No Chat Exfiltration: ChatGard never reads, records, intercepts, or transmits your messages, contact lists, phone numbers, or media files.
ChatGard is an independent open-source project and is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp LLC, Meta Platforms, Inc., Telegram FZ-LLC, Telegram Messenger Inc., or any of their subsidiaries or affiliates. The official WhatsApp website can be found at https://whatsapp.com, and the official Telegram website can be found at https://telegram.org.
MIT