Skip to content
fblaztPublic

About

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.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ChatGard: Screen Privacy for Web Messengers

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.

ChatGard demo showing blur protection, hover to reveal, and selective privacy controls

Features

  • 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.

Installation from Release

Download the pre-built zip file for your browser from the latest GitHub Releases.

Chromium-based Browsers (Chrome, Brave, Edge)

  1. Download the chatgard-*-chrome.zip archive from the release assets and extract it to a folder.
  2. Open your browser's extensions page:
    • Chrome: chrome://extensions
    • Brave: brave://extensions
    • Edge: edge://extensions
  3. Toggle Developer mode on (in the top-right corner).
  4. Click Load unpacked and select the extracted folder.
  5. Open WhatsApp Web or Telegram Web A to use ChatGard.

Firefox (Experimental / Untested)

  1. Download the chatgard-*-firefox.zip archive from the release assets and extract it to a folder.
  2. Open about:debugging#/runtime/this-firefox in Firefox.
  3. Click Load Temporary Add-on....
  4. Select the manifest.json file inside the extracted folder.
  5. 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.

Building from Source

Prerequisites

Setup & Build

Install project dependencies:

bun install

Start the development server:

bun run dev           # Chromium (default)
bun run dev:firefox   # Firefox

Build 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 test

Run TypeScript type checking:

bun run compile

Loading Unpacked Development Build

  • 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.

Browser Compatibility

  • Chromium-based browsers (Chrome, Brave, Edge): Supported and tested.
  • Firefox: Experimental / Not fully tested yet (Manifest V2 build available via bun run build:firefox).

Privacy & Security

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.

Disclaimer

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.

License

MIT

About

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.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages