Local Lens v2.2.0 🍎🪟

Local Lens v2.2.0

This is a landmark release that brings Local Lens to macOS! For the first time, Mac users with Apple Silicon (M1/M2/M3/M4) can enjoy the full Local Lens experience with native performance.

🍎 macOS Support (Apple Silicon)

• Native Apple Silicon Build: Fully optimized for M1, M2, M3, and M4 Macs with native ARM64 binaries.
• DMG Installer: Simple drag-and-drop installation to your Applications folder.
• Auto-Updates: macOS users get the same seamless update experience as Windows users.
• Optimized Startup: Uses a one-folder architecture for fast app launches (no extraction delays).

✨ New Features

• Cross-Platform CI/CD: Automated GitHub Actions builds for both Windows and macOS ensure consistent, reproducible releases.
• Improved Backend Reliability: New health check system ensures the backend is fully ready before the UI connects.
• Custom Save Preset Dialog: Beautiful native-style modal for saving presets (fixes macOS compatibility).

🐛 Bug Fixes

• "With Others" Folder Fix: Photos with only unknown faces no longer incorrectly create a "With Others" subfolder.
• Face Enrollment Loading: Fixed issue where enrolled faces weren't loading on app startup.
• Multiprocessing Stability: Resolved PyInstaller freeze issues on both platforms.

---

⬇️ Installation

Windows

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

macOS (Apple Silicon)

1. Download Local_Lens_v2.2.0_aarch64.dmg
2. Open the DMG and drag Local Lens to your Applications folder
3. First launch only: Right-click the app → Click Open → Click Open in the dialog

   This is required because the app is not notarized with Apple. You only need to do this once.

🔄 Updating from Previous Versions

• Windows users: Your face encodings and presets are preserved. Updates install seamlessly via the in-app notification bell.
• macOS users: This is the first macOS release - welcome! 🎉

---

🔒 Security & Verification

This release was built automatically using GitHub Actions for both platforms:

• Source Code: Available in this repository at tag v2.2.0
• Build Process: View the complete build log in the Actions tab
• Signed Updates: All updates are cryptographically signed to ensure authenticity.
• Checksums: SHA256 checksums provided for both platforms.

✅ File Verification

Windows:

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

macOS:

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

Local Lens v2.1.0

Local Lens v2.1.0

This is a significant feature release that introduces a comprehensive user onboarding experience and dramatically expands RAW image format support for macOS and Linux users.

✨ New Features

• Interactive Tutorial & Walkthrough: A brand-new, step-by-step tutorial has been added to guide first-time users through the application's core features, from selecting folders to sorting photos and enrolling faces.
• Expanded RAW Image Support (macOS & Linux): Thanks to the integration of ImageMagick, Local Lens now supports a much wider range of RAW image formats on macOS and Linux, including formats from many newer cameras.

⬆️ Improvements

• Modernized Build Process: The release build process is now more robust, using dynamic logic to correctly package the backend executable for different operating systems and CPU architectures.
• Dependency Updates: Replaced the deprecated pkg_resources library with a modern equivalent, ensuring better compatibility and performance for face recognition tasks.

Preview

Apologies for the gif quality !

---

⬇️ Installation

1. Click on Local_Lens_v2.1.0_x64_en-US.msi for the Windows installer.
2. Run the installer as Administrator (recommended).
3. Follow the installation wizard.
4. Launch Local Lens from the Start Menu or Desktop shortcut.

🔄 Updating from Previous Versions

If you're upgrading from a previous version:

• Your face encodings and presets will be preserved.
• Updates can be installed directly from within the app via the notification bell icon!

🔒 Security & Verification

This Windows release was built and signed automatically using GitHub Actions:

• Source Code: Available in this repository at tag v2.1.0
• Build Process: View the complete build log in the Actions tab
• Signed Updates: All updates are cryptographically signed to ensure authenticity.
• Checksums: SHA256 checksums provided in checksums-windows.txt for file verification.

✅ File Verification

After downloading, verify file integrity:

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

Local Lens v2.0.6

Local Lens v2.0.6

A maintenance release focused on improving preset management reliability and user experience. This update addresses a critical crash when loading presets with missing folders and adds convenient preset management features.

🐛 Bug Fixes

• Critical Fix: Preset Path Validation: Fixed a crash that occurred when selecting a saved preset whose source or destination folder had been deleted or moved. The application now validates paths before loading and displays a clear error dialog instead of crashing.
• Critical Fix: 'Find & Group' Result Dialog: Fixed an issue where the completion dialog would display incorrect information (e.g., "No Matches Found") even when photos were successfully found and copied. The dialog now accurately reflects the operation results.

✨ New Features

• Preset Delete Button: Added a delete button next to the preset dropdown, allowing users to easily remove outdated or invalid presets directly from the interface.
• Smart Invalid Preset Handling: When loading a preset with missing paths, users are now prompted with options to either delete the invalid preset or keep it for later.

⬆️ Improvements

• Simplified 'Find & Group' Operations: The "Copy/Move" toggle has been removed from the "Find & Group" mode. This operation now always copies files to prevent accidental data loss and reduce user confusion. The toggle remains available in Standard and Hybrid sorting modes.
• Improved Error Handling: Enhanced API error handling to distinguish between network failures and HTTP errors, preventing false "backend disconnected" warnings.

Preview

---

⬇️ Installation

1. Click on Local_Lens_v2.0.6_x64_en-US.msi for the Windows installer
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from Start Menu or Desktop shortcut

🔄 Updating from Previous Versions

If you're upgrading from a previous version:

• Your face encodings and presets will be preserved
• Updates can be installed directly from within the app via the notification bell icon!

🔒 Security & Verification

This Windows release was built and signed automatically using GitHub Actions:

• Source Code: Available in this repository at tag v2.0.6
• Build Process: View the complete build log in the Actions tab
• Signed Updates: All updates are cryptographically signed to ensure authenticity
• Checksums: SHA256 checksums provided in checksums-windows.txt for file verification

✅ File Verification

After downloading, verify file integrity:

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

Local Lens v2.0.5

Local Lens v2.0.5

This is a significant release for Local Lens, focused on streamlining the user experience and introducing a seamless auto-update system. We've simplified the "Find & Group" workflow, improved backend stability, and made it easier than ever to stay up-to-date with future releases.

✨ New Features

• In-App Auto-Update Notifications: Local Lens now automatically checks for new versions on startup. When an update is available, a notification bell icon appears in the top-left corner of the application. Click it to view the full release notes and install the update with a single click—no more manually downloading from GitHub!

⬆️ Improvements

• Simplified 'Find & Group' Operations: The "Copy/Move" toggle has been removed from the "Find & Group" mode. This operation now always copies files to prevent accidental data loss and reduce user confusion. The toggle remains available in Standard and Hybrid sorting modes.
• Reliable Backend Connection: The Python backend now uses a consistent port (8000) in development mode instead of randomly selecting one. This ensures a stable and predictable connection between the Tauri frontend and the backend server.
• Optimized Dependencies: Cleaned up and optimized package dependencies for improved performance and reduced application size.
• Enhanced Documentation: Added detailed production build instructions to the setup guide for developers and contributors.

🐛 Bug Fixes

• Critical Fix: 'Find & Group' Result Dialog: Fixed an issue where the completion dialog would display incorrect information (e.g., "No Matches Found") even when photos were successfully found and copied. The dialog now accurately reflects the operation results.
• Fixed Enrollment Triggering Wrong Modal: Resolved a bug where completing a face enrollment while in "Find & Group" mode would incorrectly trigger the Find Results modal instead of the enrollment completion message.
• Fixed Version Display: Corrected the version number shown in the update notification panel.

Preview

---

⬇️ Installation

1. Click on Local_Lens_v2.0.5_x64_en-US.msi for the Windows installer
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from Start Menu or Desktop shortcut

🔄 Updating from v1.x or v2.0.0

If you're upgrading from a previous version:

• Your face encodings and presets will be preserved
• Future updates can be installed directly from within the app!

🔒 Security & Verification

This Windows release was built and signed automatically using GitHub Actions:

• Source Code: Available in this repository at tag v2.0.5
• Build Process: View the complete build log in the Actions tab
• Signed Updates: All updates are cryptographically signed to ensure authenticity
• Checksums: SHA256 checksums provided in checksums-windows.txt for file verification

✅ File Verification

After downloading, verify file integrity:

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

Local Lens v2.0.1

Local Lens v2.0.1

This is a significant release for Local Lens, focused on streamlining the user experience and introducing a seamless auto-update system. We've simplified the "Find & Group" workflow, improved backend stability, and made it easier than ever to stay up-to-date with future releases.

✨ New Features

• In-App Auto-Update Notifications: Local Lens now automatically checks for new versions on startup. When an update is available, a notification bell icon appears in the top-left corner of the application. Click it to view the full release notes and install the update with a single click—no more manually downloading from GitHub!

⬆️ Improvements

• Simplified 'Find & Group' Operations: The "Copy/Move" toggle has been removed from the "Find & Group" mode. This operation now always copies files to prevent accidental data loss and reduce user confusion. The toggle remains available in Standard and Hybrid sorting modes.
• Reliable Backend Connection: The Python backend now uses a consistent port (8000) in development mode instead of randomly selecting one. This ensures a stable and predictable connection between the Tauri frontend and the backend server.
• Optimized Dependencies: Cleaned up and optimized package dependencies for improved performance and reduced application size.
• Enhanced Documentation: Added detailed production build instructions to the setup guide for developers and contributors.

🐛 Bug Fixes

• Critical Fix: 'Find & Group' Result Dialog: Fixed an issue where the completion dialog would display incorrect information (e.g., "No Matches Found") even when photos were successfully found and copied. The dialog now accurately reflects the operation results.
• Fixed Enrollment Triggering Wrong Modal: Resolved a bug where completing a face enrollment while in "Find & Group" mode would incorrectly trigger the Find Results modal instead of the enrollment completion message.
• Fixed Version Display: Corrected the version number shown in the update notification panel.

Preview

---

⬇️ Installation

1. Click on Local_Lens_v2.0.1_x64_en-US.msi for the Windows installer
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from Start Menu or Desktop shortcut

🔄 Updating from v1.x or v2.0.0

If you're upgrading from a previous version:

• Your face encodings and presets will be preserved
• Future updates can be installed directly from within the app!

🔒 Security & Verification

This Windows release was built and signed automatically using GitHub Actions:

• Source Code: Available in this repository at tag v2.0.1
• Build Process: View the complete build log in the Actions tab
• Signed Updates: All updates are cryptographically signed to ensure authenticity
• Checksums: SHA256 checksums provided in checksums-windows.txt for file verification

✅ File Verification

After downloading, verify file integrity:

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

Local Lens v2.0.0

Local Lens v2.0.0

This is a significant release for Local Lens, focused on streamlining the user experience and introducing a seamless auto-update system. We've simplified the "Find & Group" workflow, improved backend stability, and made it easier than ever to stay up-to-date with future releases.

✨ New Features

• In-App Auto-Update Notifications: Local Lens now automatically checks for new versions on startup. When an update is available, a notification bell icon appears in the top-left corner of the application. Click it to view the full release notes and install the update with a single click—no more manually downloading from GitHub!

⬆️ Improvements

• Simplified 'Find & Group' Operations: The "Copy/Move" toggle has been removed from the "Find & Group" mode. This operation now always copies files to prevent accidental data loss and reduce user confusion. The toggle remains available in Standard and Hybrid sorting modes.
• Reliable Backend Connection: The Python backend now uses a consistent port (8000) in development mode instead of randomly selecting one. This ensures a stable and predictable connection between the Tauri frontend and the backend server.
• Optimized Dependencies: Cleaned up and optimized package dependencies for improved performance and reduced application size.
• Enhanced Documentation: Added detailed production build instructions to the setup guide for developers and contributors.

🐛 Bug Fixes

• Critical Fix: 'Find & Group' Result Dialog: Fixed an issue where the completion dialog would display incorrect information (e.g., "No Matches Found") even when photos were successfully found and copied. The dialog now accurately reflects the operation results.
• Fixed Enrollment Triggering Wrong Modal: Resolved a bug where completing a face enrollment while in "Find & Group" mode would incorrectly trigger the Find Results modal instead of the enrollment completion message.

Preview

---

⬇️ Installation

1. Click on Local_Lens_v2.0.0_x64_en-US.msi for the Windows installer
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from Start Menu or Desktop shortcut

🔄 Updating from v1.x

If you're upgrading from a previous version:

• Your face encodings and presets will be preserved
• Future updates can be installed directly from within the app!

🔒 Security & Verification

This Windows release was built and signed automatically using GitHub Actions:

• Source Code: Available in this repository at tag v2.0.0
• Build Process: View the complete build log in the Actions tab
• Signed Updates: All updates are cryptographically signed to ensure authenticity
• Checksums: SHA256 checksums provided in checksums-windows.txt for file verification

✅ File Verification

After downloading, verify file integrity:

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

Local Lens v1.2.0

Local Lens v1.2.0

This is a major feature and stability release for Local Lens, introducing long-awaited functionality and fixing critical bugs. The highlight of this version is the new Copy/Move toggle, giving users non-destructive organization options. We've also completely overhauled the subfolder selection for more granular control and implemented a new automatic update system to make getting future releases seamless.

✨ New Features

• Operation Mode: Copy or Move: You now have the choice! A new toggle in the main interface allows you to select between the original 'Move' behavior and a new, non-destructive 'Copy' mode. The application now defaults to 'Copy' for enhanced safety.
• Automatic Application Updates: Local Lens can now automatically check for new versions on startup. If an update is available, you will be notified directly within the app with an option to download and install it seamlessly.

⬆️ Upgrades

• Hierarchical Subfolder Selection: The subfolder exclusion list has been upgraded to a full hierarchical tree view. You can now expand and collapse folders to see their structure and ignore entire branches or individual subfolders with much greater precision.
• UI/UX Enhancements:
  • The "Copy/Move" toggle has been redesigned with a modern, glassy aesthetic to improve clarity and usability.
  • After a successful 'Move' operation, the UI now gracefully resets, preventing errors from pointing to a deleted source folder.

🐛 Bug Fixes

• Major Fix: File Locking on 'Move': Resolved a critical bug that caused "Access Denied" errors when moving photos from one drive to another (e.g., from an SD card to a hard drive). The metadata extraction process has been re-engineered to prevent it from holding onto file handles, ensuring move operations are now stable and reliable.
• Major Fix: Hybrid Mode Incompleteness: Corrected a flaw in 'Hybrid' mode where only photos matching a "special" folder rule were moved, while other photos were incorrectly left behind in the source directory. All photos are now correctly processed and moved as expected.
• File Count Accuracy: The "supported files" counter now updates accurately when ignoring or re-including nested subfolders, providing a reliable preview of the operation.

Preview

⬇️ Installation

1. Click on Local_Lens_v1.2.0_x64_en-US.msi for windows installer
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from Start Menu or Desktop shortcut

🔒 Security & Verification

This Windows release was built automatically using GitHub Actions:

• Source Code: Available in this repository at tag v1.2.0
• Build Process: View the complete build log in the Actions tab
• Checksums: SHA256 checksums provided below for file verification

✅ File Verification

After downloading, verify file integrity:

certutil -hashfile "installer_name" SHA256

Compare the output with the checksums in checksums-windows.txt.

Local Lens v1.1.0 - Windows Release

Local Lens v1.1.0

🚀 Installation

1. Go below, find the Local_Lens_v1.1.0_x64_en-US.msi click on it (download will start)
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from the Start Menu or the Desktop shortcut

🖼️ Preview

🔒 Security & Verification (optional)

This Windows release was built automatically using GitHub Actions:

• Source Code: Available in this repository at tag v1.1.0
• Build Process: View the complete build log in the Actions tab
• Checksums: SHA256 checksums provided below for file verification

✅ File Verification (optional)

After downloading, verify file integrity:

certutil -hashfile "installer_name" SHA256

Compare the output with the checksums in checksums-windows.txt.

Local Lens v1.0.3 - Initial Windows Release

Local Lens v1.0.3

🚀 Installation

1. Download your preferred installer format
2. Run the installer as Administrator (recommended)
3. Follow the installation wizard
4. Launch Local Lens from Start Menu or Desktop shortcut

🖼️ Preview

🔒 Security & Verification (optional)

This Windows release was built automatically using GitHub Actions:

• Source Code: Available in this repository at tag v1.0.3
• Build Process: View the complete build log in the Actions tab
• Checksums: SHA256 checksums provided below for file verification

✅ File Verification (optional)

After downloading, verify file integrity:

certutil -hashfile "installer_name" SHA256

Compare the output with the checksums in checksums-windows.txt.