Skip to content

dch09/Lens

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lens

Alpha — expect bugs. Please report issues on GitHub.

Menu bar app for macOS that blurs the desktop and leaves your focused window sharp. A full-screen surface on each display sits just below visible windows in Z-order — no Accessibility API, no window masks.

Requires macOS 26.2+. Build with Xcode 26.

Download (pre-built)

Latest release: GitHub Releases

  1. Download Lens-x.y.z.dmg from the latest release
  2. Open the DMG and drag Lens to Applications
  3. Launch Lens from Applications

First launch (Gatekeeper)

Lens is not notarized (no paid Apple Developer account). macOS may block the first launch with an “unidentified developer” warning.

Option A: Right-click Lens in Applications → Open → confirm Open.

Option B: Remove the download quarantine flag:

xattr -dr com.apple.quarantine /Applications/Lens.app

If needed: System Settings → Privacy & Security → Open Anyway.

Build from source

git clone https://github.com/dch09/Lens.git
cd Lens
open Lens.xcodeproj

Run the Lens scheme (⌘R). Left-click the menu bar icon to toggle focus. Right-click for the Visible submenu, Settings, and Quit. Global shortcuts are unset by default — assign them in Settings → System.

Run tests:

xcodebuild -scheme Lens -destination 'platform=macOS' test

Auto-hide menu bar / Dock

Optional toggles in Settings → System. They apply only while focus is on; your Desktop & Dock preferences are restored when focus ends. First use prompts for System Events under Privacy → Automation. If the prompt never appears after installing to /Applications, try tccutil reset AppleEvents com.dch09.Lens.

Contributing

Contributions are welcome! See CONTRIBUTING.md for setup, PR guidelines, and how to report bugs.

Notes

Lens tracks windows via CGWindowList — Accessibility is not required. It uses private APIs (CABackdropLayer, SkyLight via dlsym) and is not App Store–safe; see Lens/Lens.entitlements. Behavior can vary with Mission Control, Stage Manager, and native full-screen Spaces.

Architecture details: CLAUDE.md. Changelog: CHANGELOG.md.

MIT. KeyboardShortcuts (MIT) for global shortcut recording.

About

macOS app for displaying blurred background under currently active window

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors