|
1 | 1 | # Local Lens |
| 2 | + |
2 | 3 | [](https://www.gnu.org/licenses/agpl-3.0) |
3 | 4 | []() |
4 | | -[]() |
5 | 5 | [](https://github.com/ashesbloom/LocalLens/releases) |
6 | | -[](https://github.com/ashesbloom/LocalLens/releases/latest) |
| 6 | +[](https://github.com/ashesbloom/LocalLens/releases/latest) |
7 | 7 |
|
8 | 8 |  |
9 | 9 |  |
10 | 10 |  |
11 | 11 |
|
12 | | -[](https://coff.ee/ashesbloom) |
13 | | - |
14 | | -**Local Lens** is a powerful, AI-driven photo organization application that intelligently sorts and categorizes your photo collection using advanced facial recognition, location data, and metadata analysis. Built with modern technologies, it provides a seamless desktop experience. |
| 12 | +<br /> |
| 13 | +<div align="center"> |
| 14 | + <img src="https://github.com/ashesbloom/LocalLens/blob/main/frontend/src-tauri/icons/StoreLogo.png?raw=true" alt="Local Lens Logo" /> |
| 15 | + <h1>Your Memories, Your Machine, Your Privacy.</h1> |
| 16 | + <p><strong>Local Lens</strong> is the AI-powered home for your photos. Sort by face, location, and date entirely offline.</p> |
| 17 | + <h3> |
| 18 | + <a href="https://github.com/ashesbloom/LocalLens/releases/latest">📥 Download Latest Version (Windows)</a> |
| 19 | + </h3> |
| 20 | + <p><em>macOS and Linux support coming soon</em></p> |
| 21 | +</div> |
| 22 | +<br /> |
15 | 23 |
|
16 | 24 | ## 🖥️ Software Preview |
17 | 25 |
|
18 | | -Take a look at Local Lens in action: |
| 26 | +See how Local Lens organizes thousands of photos in seconds: |
19 | 27 |
|
20 | 28 | <p align="center"> |
21 | 29 | <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview1.png?raw=true" alt="Local Lens Main Dashboard" width="250"/> |
22 | 30 | <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview2.png?raw=true" alt="Face Recognition in Local Lens" width="250"/> |
23 | 31 | <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview3.png?raw=true" alt="Photo Organization by Location" width="250"/> |
24 | 32 | </p> |
25 | 33 |
|
26 | | -Different Modes of Local Lens: |
| 34 | +### Different Modes & Themes |
27 | 35 | <p align="center"> |
28 | 36 | <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview4.png?raw=true" alt="Different Modes of Local Lens" width="520" style="display:block; margin: 0 auto 16px auto;"/> |
29 | 37 | </p> |
30 | 38 | <p align="center"> |
31 | | - <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview5.png?raw=true" alt="Different Modes of Local Lens" width="250"/> |
32 | | - <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview6.png?raw=true" alt="Different Modes of Local Lens" width="250"/> |
| 39 | + <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview5.png?raw=true" alt="Dark Mode Interface" width="250"/> |
| 40 | + <img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview6.png?raw=true" alt="Light Mode Interface" width="250"/> |
33 | 41 | </p> |
34 | 42 |
|
35 | | -> _Screenshots are for illustration. UI may evolve with updates._ |
| 43 | +> _Screenshots are for illustration. UI evolves with every update._ |
36 | 44 |
|
37 | | -## 🎯 Vision & Purpose |
| 45 | +--- |
38 | 46 |
|
39 | | -**Local Lens** revolutionizes photo management with intelligent, privacy-first automation. Designed for photographers, families, and anyone with thousands of digital memories, it transforms overwhelming photo organization into an effortless, secure experience. |
| 47 | +## 🆚 Why Local Lens? |
40 | 48 |
|
41 | | -### The Challenge We Solve |
42 | | -Manual photo sorting is tedious, and cloud solutions risk your privacy. Local Lens brings enterprise-grade AI directly to your desktop—no subscriptions, no data leaving your device. |
| 49 | +| Feature | ☁️ Cloud Services (Google/iCloud) | 🔒 Local Lens | |
| 50 | +| :--- | :--- | :--- | |
| 51 | +| **Privacy** | Your photos are scanned for ads/data | **100% Private. Zero data leaves your PC.** | |
| 52 | +| **Cost** | Monthly Subscription ($$$) | **Free & Open Source** | |
| 53 | +| **Storage** | Limited (15GB cap) | **Unlimited (Limited only by your HDD)** | |
| 54 | +| **Speed** | Depends on Internet speed | **Instant (Local Processing)** | |
| 55 | +| **AI Processing** | Server-side | **On-Device (CNN & HOG Models)** | |
43 | 56 |
|
44 | | -### Core Philosophy: Privacy-First Intelligence |
45 | | -- **🔒 100% Local Processing**: All AI and analysis run on your machine |
46 | | -- **🛡️ Zero Data Transmission**: Photos never leave your device |
47 | | -- **⚡ Lightning-Fast Search**: Dynamic, real-time filters |
48 | | -- **🔍 Multi-Dimensional Discovery**: Search by faces, dates, locations, or combinations |
| 57 | +## 🎯 Vision & Purpose |
49 | 58 |
|
50 | | -### Intelligent Organization Features |
51 | | -- **📅 Smart Date Sorting**: Chronological organization via metadata |
52 | | -- **🗺️ Location Intelligence**: GPS clustering and reverse geocoding |
53 | | -- **👤 Face Recognition**: Train AI to recognize people |
54 | | -- **🔄 Dynamic Filtering**: Real-time, responsive search |
55 | | -- **📊 Analytics**: Insights into your photo collection |
| 59 | +**Local Lens** revolutionizes photo management with intelligent, privacy-first automation. Designed for photographers, data hoarders, families, and anyone with terabytes of digital memories, it transforms overwhelming photo organization into an effortless, secure experience. |
56 | 60 |
|
57 | | -### Enterprise-Grade Safety & Reliability |
58 | | -- **💾 Data Integrity**: Multiple validation layers for safety |
59 | | -- **🔄 Non-Destructive**: Originals untouched, smart duplicate management |
60 | | -- **📋 Logging**: Complete audit trail |
61 | | -- **⚠️ Robust Error Handling**: Graceful recovery from interruptions |
62 | | -- **🎯 Precision Accuracy**: Advanced algorithms minimize false positives |
| 61 | +### The Problem |
| 62 | +Manual photo sorting is tedious. Cloud solutions get expensive and risk your privacy. |
63 | 63 |
|
64 | | -### Advanced Features |
65 | | -- **👥 Face Enrollment**: Teach AI to recognize specific people |
66 | | -- **🌍 Cross-Platform**: Native on Windows, macOS, Linux |
67 | | -- **💾 Persistent Config**: Save/load sorting presets |
68 | | -- **🔍 Real-Time Preview**: Live analytics and progress |
69 | | -- **🎨 Modern UI**: Clean interface with React & Tauri |
| 64 | +### The Solution |
| 65 | +Local Lens brings enterprise-grade AI directly to your desktop. No subscriptions, no upload times, no data harvesting. |
70 | 66 |
|
71 | | -#### 🧠 Enhanced Automatic Strategy (How Local Lens Stays Fast & Accurate) |
| 67 | +### Core Features |
| 68 | +- **🔒 100% Offline AI**: All facial recognition and analysis runs on your hardware. |
| 69 | +- **👤 Face Recognition**: Train the AI to recognize friends and family. |
| 70 | +- **🗺️ Location Intelligence**: Visualizes where your photos were taken (GPS clustering). |
| 71 | +- **📅 Smart Timeline**: Auto-sorts messy folders into chronological order. |
| 72 | +- **⚡ Lightning Search**: Dynamic filtering by date, location, or person. |
| 73 | +- **🔄 Non-Destructive**: Your original files are never modified; we only organize. |
72 | 74 |
|
73 | | -Local Lens uses an adaptive, two-pass face recognition strategy for maximum accuracy and stability: |
| 75 | +### 🧠 Under the Hood: The "Enhanced Automatic Strategy" |
74 | 76 |
|
75 | | -- **Conservative Start**: Begins with minimal parallel processing for stability on all hardware. |
76 | | -- **Best-Model First**: Tries the high-accuracy 'cnn' model for each image. |
77 | | -- **Intelligent Fallback**: If 'cnn' fails (e.g., due to memory limits), it logs a warning and instantly retries with the lighter 'hog' model—ensuring no image is skipped. |
78 | | -- **Accurate Model Approach**: |
79 | | - - **First Pass**: Runs the fast 'hog' model for initial detection. |
80 | | - - **Confidence Check**: If a high-confidence match is found, it's accepted. |
81 | | - - **Second Pass**: If not, escalates to the more accurate 'cnn' model for tough cases. |
| 77 | +How do we keep it fast without crashing your PC? Local Lens uses an adaptive, two-pass strategy: |
82 | 78 |
|
83 | | -This guarantees the best possible result for every photo, adapting to your hardware and image complexity—never crashing or missing faces. |
| 79 | +1. **The Speed Pass (HOG)**: We scan images using a lightweight algorithm (Histogram of Oriented Gradients). If a face is clearly visible, we log it. |
| 80 | +2. **The Precision Pass (CNN)**: If the first pass is unsure, we escalate to a Convolutional Neural Network (CNN) for high-precision detection. |
| 81 | +3. **Intelligent Fallback**: If your hardware runs out of memory, the system automatically adjusts to a lighter model instantly. |
84 | 82 |
|
| 83 | +*This guarantees the best possible result for every photo, adapting to your specific hardware.* |
85 | 84 |
|
86 | | -### 🖼️ Supported Formats |
| 85 | +--- |
87 | 86 |
|
88 | | -Local Lens supports a wide range of image formats for both professional and casual users: |
| 87 | +## 🖼️ Supported Formats |
89 | 88 |
|
90 | | -`.jpg`, `.jpeg`, `.png`, `.gif`, `.bmp`, `.tiff`, `.tif`, `.webp`, `.heic`, `.heif`, `.dng`, `.cr2`, `.cr3`, `.nef`, `.arw`, `.raf`, `.avif`, `.psd`, `.hdr` |
| 89 | +Whether you shoot on an iPhone or a DSLR, we've got you covered: |
91 | 90 |
|
92 | | -Whether you shoot on a phone or a pro camera, your images are covered. |
| 91 | +`.jpg`, `.jpeg`, `.png`, `.gif`, `.bmp`, `.tiff`, `.webp`, `.heic`, `.heif` |
| 92 | +**RAW Support:** `.dng`, `.cr2`, `.cr3`, `.nef`, `.arw`, `.raf`, `.avif`, `.psd` |
93 | 93 |
|
94 | 94 | --- |
95 | 95 |
|
|
0 commit comments