Skip to content

Commit 665a923

Browse files
committed
update README.md
1 parent c6e6643 commit 665a923

3 files changed

Lines changed: 52 additions & 52 deletions

File tree

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ __pycache__/
77
# Helpers for developer
88
.github/copilot-instructions.md
99
bugs.txt
10-
changes
10+
Changes
1111
Key.txt
1212

1313
# C extensions

README.md

Lines changed: 51 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,95 +1,95 @@
11
# Local Lens
2+
23
[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
34
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-blue.svg)]()
4-
[![Build Status](https://img.shields.io/badge/Build-Passing-green.svg)]()
55
[![GitHub release](https://img.shields.io/github/v/release/ashesbloom/LocalLens)](https://github.com/ashesbloom/LocalLens/releases)
6-
[![GitHub downloads](https://img.shields.io/github/downloads/ashesbloom/LocalLens/total)](https://github.com/ashesbloom/LocalLens/releases/latest)
6+
[![GitHub downloads](https://img.shields.io/github/downloads/ashesbloom/LocalLens/total?color=success&label=Downloads&logo=windows)](https://github.com/ashesbloom/LocalLens/releases/latest)
77

88
![GitHub stars ](https://img.shields.io/github/stars/ashesbloom/LocalLens?style=social&cacheSeconds=60)
99
![GitHub forks ](https://img.shields.io/github/forks/ashesbloom/LocalLens?style=social&cacheSeconds=60)
1010
![Views](https://komarev.com/ghpvc/?username=ashesbloom&repo=Locallens&color=blue&style=plastic&label=Views+so+far)
1111

12-
[![Buy Me A Coffee](https://img.shields.io/badge/-Buy%20me%20a%20coffee-FFDD00?style=flat&logo=buy-me-a-coffee&logoColor=black)](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 />
1523

1624
## 🖥️ Software Preview
1725

18-
Take a look at Local Lens in action:
26+
See how Local Lens organizes thousands of photos in seconds:
1927

2028
<p align="center">
2129
<img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview1.png?raw=true" alt="Local Lens Main Dashboard" width="250"/>
2230
<img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview2.png?raw=true" alt="Face Recognition in Local Lens" width="250"/>
2331
<img src="https://github.com/ashesbloom/LocalLens/blob/main/assets/preview3.png?raw=true" alt="Photo Organization by Location" width="250"/>
2432
</p>
2533

26-
Different Modes of Local Lens:
34+
### Different Modes & Themes
2735
<p align="center">
2836
<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;"/>
2937
</p>
3038
<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"/>
3341
</p>
3442

35-
> _Screenshots are for illustration. UI may evolve with updates._
43+
> _Screenshots are for illustration. UI evolves with every update._
3644
37-
## 🎯 Vision & Purpose
45+
---
3846

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?
4048

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)** |
4356

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
4958

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.
5660

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.
6363

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.
7066

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.
7274

73-
Local Lens uses an adaptive, two-pass face recognition strategy for maximum accuracy and stability:
75+
### 🧠 Under the Hood: The "Enhanced Automatic Strategy"
7476

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:
8278

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.
8482

83+
*This guarantees the best possible result for every photo, adapting to your specific hardware.*
8584

86-
### 🖼️ Supported Formats
85+
---
8786

88-
Local Lens supports a wide range of image formats for both professional and casual users:
87+
## 🖼️ Supported Formats
8988

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:
9190

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`
9393

9494
---
9595

-124 Bytes
Loading

0 commit comments

Comments
 (0)