Skip to content

About

πŸ”’ A macOS menu bar app that blurs WhatsApp's chat list for privacy. Hover to reveal.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

Β 

History

1 Commit

Folders and files

Repository files navigation

WhatsApp Privacy Blur πŸ”’

macOS 13.0+ Swift 6.0 MIT License

Keep your WhatsApp chats private with an intelligent blur overlay.
A lightweight macOS menu bar app that automatically blurs your WhatsApp sidebar.


✨ Features

  • 🎯 Smart Blur - Automatically blurs chat list and header for instant privacy
  • πŸ‘† Hover to Reveal - Smooth fade animation reveals content on hover
  • πŸ“ Auto-Detect Width - Uses Accessibility APIs to detect sidebar width
  • 🎨 Blur Intensity - Choose from Light, Medium, or Heavy blur
  • βš™οΈ Manual Control - Adjust overlay width with slider (200-500px)
  • πŸš€ Launch at Login - Auto-start on macOS login (macOS 13+)
  • 🌟 Menu Bar App - Lives in your menu bar, no dock icon clutter

πŸ“Έ Preview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ πŸ”’ WhatsApp Privacy Blur               β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ βœ“ Enabled                              β”‚
β”‚ βœ“ Auto-detect Width                    β”‚
β”‚   Width: 308px [━━━━━━━━━━━━━━━]      β”‚
β”‚ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ β”‚
β”‚   Blur Intensity      β€Ί Medium βœ“       β”‚
β”‚ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ β”‚
β”‚ βœ“ Launch at Login                      β”‚
β”‚ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ β”‚
β”‚   Quit                                 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ Installation

Easy Install (Recommended)

./install.sh

This builds the release binary and installs it as a proper macOS app to /Applications/WhatsApp Privacy Blur.app.

Manual Build

swift build -c release
.build/release/HideWhatsApp

πŸ”§ Requirements

  • macOS 13.0 or later
  • Accessibility permission (required for window detection)
  • WhatsApp Desktop app

πŸ“– Usage

  1. Launch the app - Find it via Spotlight or in /Applications
  2. Grant accessibility permission - Required for detecting WhatsApp window position
  3. Open WhatsApp - Blur overlay appears automatically
  4. Hover to reveal - Move cursor over blur to temporarily reveal content
  5. Configure - Click menu bar icon for settings

βš™οΈ Configuration

Menu Bar Options

Option Description
Enabled Toggle blur on/off (⌘+E)
Auto-detect Width Automatically detect sidebar width via Accessibility APIs
Width Slider Manually adjust overlay width (200-500px)
Blur Intensity Choose Light, Medium, or Heavy blur effect
Launch at Login Auto-start on macOS login (uses SMAppService)
Quit Exit the app (⌘+Q)

Settings Persistence

All settings are saved automatically via UserDefaults and persist across app restarts.

πŸ—οΈ Architecture

Sources/HideWhatsApp/
β”œβ”€β”€ main.swift              # Entry point
β”œβ”€β”€ AppDelegate.swift       # App lifecycle
β”œβ”€β”€ StatusBar.swift         # Menu bar UI
β”œβ”€β”€ Settings.swift          # User preferences
β”œβ”€β”€ LaunchAtLogin.swift     # SMAppService wrapper
β”œβ”€β”€ BlurOverlay.swift       # Blur window rendering
└── WhatsAppMonitor.swift   # Window position tracking

πŸ” Privacy

  • No data collection - Everything runs locally
  • No network requests - Zero external communication
  • No analytics - Your privacy is paramount
  • Open source - Audit the code yourself

πŸ› οΈ Development

Build

swift build

Run (Debug)

swift run

Clean

swift package clean

πŸ“ Changelog

See CHANGELOG.md for version history.

Latest (v1.2.0)

  • βœ… Proper macOS app bundle
  • βœ… Launch at Login support
  • βœ… Install script for easy setup

🀝 Contributing

Contributions welcome! Feel free to open issues or submit PRs.

πŸ“„ License

MIT License - See LICENSE for details.

πŸ™ Acknowledgments

Built with Swift and macOS AppKit. Uses:

  • NSWindow for overlay rendering
  • Accessibility APIs for window detection
  • SMAppService for login item registration
  • UserDefaults for settings persistence

Made with ❀️ for privacy-conscious WhatsApp users

About

πŸ”’ A macOS menu bar app that blurs WhatsApp's chat list for privacy. Hover to reveal.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages