Skip to content

Local Lens v2.2.1

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 31 Dec 12:14
v2.2.1
2fb67ca

Local Lens v2.2.1

This release makes macOS installation much easier! We've added Homebrew support for one-command installation and a fix script that eliminates the "App is damaged" error.

🎉 Homebrew Support (Recommended for macOS)

Mac users can now install Local Lens with a single command:

brew install ashesbloom/locallens/local-lens

Why Homebrew is recommended:

  • Automatically removes Gatekeeper quarantine
  • No manual security bypass needed
  • Easy updates with brew upgrade local-lens
  • Clean uninstall with brew uninstall local-lens

🔧 macOS Gatekeeper Fix Script

For users who prefer the DMG installer, we now include Fix_Local_Lens.command — a double-clickable script that fixes the "App is damaged" error automatically.

What it does:

  • Removes the quarantine flag from the app
  • Applies an ad-hoc code signature
  • Sets correct executable permissions
  • Works for both /Applications and ~/Applications

✨ What's New

  • Homebrew Cask Support: Install via brew install ashesbloom/locallens/local-lens
  • Fix Script Included: Fix_Local_Lens.command bundled with every release
  • Improved Documentation: Clear installation instructions for all scenarios
  • Auto-Generated Cask Formula: local-lens.rb included in release assets for tap updates

⬇️ Installation

macOS via Homebrew (Recommended) 🍺

brew install ashesbloom/locallens/local-lens

That's it! Homebrew handles everything automatically.

macOS Manual Install (DMG)

  1. Download Local_Lens_v2.2.1_aarch64.dmg
  2. Download Fix_Local_Lens.command
  3. Open the DMG and drag Local Lens to your Applications folder
  4. Double-click Fix_Local_Lens.command and enter your password when prompted
  5. Launch Local Lens normally

Alternative methods if the fix script doesn't work:

  • Right-click the app → Click Open → Click Open in the dialog
  • Or run in Terminal: 
    xattr -cr "/Applications/Local Lens.app"

Windows

  1. Download Local_Lens_v2.2.1_x64_en-US.msi (or .exe for NSIS installer)
  2. Run the installer
  3. Launch Local Lens from the Start Menu

⚠️ Why macOS Shows Security Warnings

Local Lens is not notarized with Apple because:

  • Apple requires a $99/year developer subscription
  • We're an open-source project prioritizing accessibility

The app is safe — the warnings appear because macOS doesn't recognize our signature. The Homebrew installation or the fix script resolves this completely.

🔄 Updating from v2.2.0

  • Windows users: Updates install seamlessly via the in-app notification bell
  • macOS users:
    • Homebrew: brew upgrade local-lens
    • Manual: Download new DMG and run the fix script again

🔒 Security & Verification

This release was built automatically using GitHub Actions:

  • Source Code: Available at tag v2.2.1
  • Build Process: View build logs in the Actions tab
  • Signed Updates: Cryptographically signed for authenticity
  • Checksums: SHA256 checksums provided for verification

✅ File Verification

macOS:

shasum -a 256 "Local_Lens_v2.2.1_aarch64.dmg"

Windows:

certutil -hashfile "Local_Lens_v2.2.1_x64_en-US.msi" SHA256

📦 Release Assets

File Description
Local_Lens_v2.2.1_aarch64.dmg macOS installer (Apple Silicon)
Fix_Local_Lens.command macOS Gatekeeper fix script
local-lens.rb Homebrew Cask formula
Local_Lens_v2.2.1_x64_en-US.msi Windows MSI installer
Local_Lens_v2.2.1_x64-setup.exe Windows EXE installer
checksums-macos.txt SHA256 checksums for macOS
checksums-windows.txt SHA256 checksums for Windows
Assets 11
Loading