`bash


Search by ISO range

| Filter | Type | Description | Examples |
|--------|------|-------------|----------|
| --iso | Range | ISO sensitivity | 100, 100-800, >1600, <400 |
| --aperture | Range | Aperture f-stop | 1.4, 1.4-2.8, <4, >5.6 |
| --shutter | Range | Shutter speed (seconds) | 0.001, 0.001-0.01, <0.0001 |
| --focal | Range | Focal length (mm) | 50, 35-85, >100, <24 |
| --camera | Text | Camera model (partial) | "Nikon", "D850", "Canon" |
| --lens | Text | Lens model (partial) | "70-200", "Sigma", "f/1.4" |
| --date | Date | Capture date | 2024-01-15, 2024-01-01:2024-12-31 |
| --orientation | Enum | Image orientation | landscape, portrait, square |
| --flash | Boolean | Flash fired | true, false |

#### Options

| Option | Description | Default |
|--------|-------------|---------|
| -r, --recursive | Scan subdirectories | true |
| --sort | Sort by: iso, aperture, shutter, focal, date | - |
| --desc | Sort descending | false |
| --limit | Limit results | 100 |
| --paths | Show full file paths | false |
| --json | Output as JSON | false |
| --help-filters | Show filter help | - |

---

$3

Display comprehensive statistics for photos in a directory.

`bash


Basic statistics

| Option | Description | Default |
|--------|-------------|---------|
| -r, --recursive | Scan subdirectories | true |
| -v, --verbose | Show detailed statistics | false |
| -c, --compact | Hide distribution charts | false |
| -o, --output | Save to file (.md, .html, .json) | - |
| --json | Output JSON to stdout | false |

#### Export Formats

| Format | Extension | Description |
|--------|-----------|-------------|
| Markdown | .md | Tables and formatted text, ideal for GitHub/docs |
| HTML | .html | Visual report with bar charts, dark theme |
| JSON | .json | Raw data for programmatic use |

---

$3

Detect and optionally remove duplicate photos.

`bash


Find duplicates

| Method | Description | Use Case |
|--------|-------------|----------|
| hash | Compares file content (first/last 64KB + size) | Exact duplicates |
| exif | Compares EXIF signature (camera, timestamp, settings) | Same photo, different processing |
| hybrid | Uses EXIF first, falls back to hash | Most accurate (default) |

#### Options

| Option | Description | Default |
|--------|-------------|---------|
| -r, --recursive | Scan subdirectories | true |
| -m, --method | Detection: hash, exif, hybrid | hybrid |
| --delete | Delete duplicates (keeps oldest) | false |
| -d, --dry-run | Preview deletions | true |
| --json | Output as JSON | false |

---

$3

Display detailed analysis of a single image.

`bash
classify info ./photo.NEF
`

Shows:
- EXIF metadata (camera, lens, settings)
- Quality scores (sharpness, exposure, composition, etc.)
- Overall score and rating
- Detected issues and suggestions

---

Output Structure

When organizing files, the following structure is created:

`
organized/
├── selects/ # Score 72+ (5 stars)
│ ├── 001_select_s85_r5.NEF
│ └── 002_select_s78_r5.NEF
├── good/ # Score 58-71 (4 stars)
│ ├── 003_good_s67_r4.NEF
│ └── 004_good_s62_r4.NEF
├── review/ # Score 45-57 (3 stars)
│ └── 005_review_s52_r3.NEF
├── maybe/ # Score 30-44 (2 stars)
│ └── 006_maybe_s38_r2.NEF
├── reject/ # Score <30 or critical issues (1 star)
│ └── 007_reject_s22_r1.NEF
├── _manifest.json # For undo/restore
└── _report.html # Visual report (if --report used)
`

$3

Files are renamed with the pattern: {sequence}_{category}_s{score}_r{rating}.{ext}

- sequence: 3-digit number based on score ranking
- category: select, good, review, maybe, reject
- score: 0-100 quality score
- rating: 1-5 star rating

---

Scoring System

$3

| Metric | General | Landscape |
|--------|---------|-----------|
| Sharpness | 25% | 20% |
| Exposure | 25% | 25% |
| Focus Accuracy | 15% | - |
| Composition | 15% | 25% |
| Noise | 10% | 5% |
| Dynamic Range | 10% | 15% |
| Horizon Level | - | 10% |

$3

| Category | Score Range | Stars |
|----------|-------------|-------|
| Select | 72+ | ★★★★★ |
| Good | 58-71 | ★★★★☆ |
| Review | 45-57 | ★★★☆☆ |
| Maybe | 30-44 | ★★☆☆☆ |
| Reject | <30 | ★☆☆☆☆ |

$3

Images are automatically rejected if:
- Severe motion blur (>85% severity)
- Severely out of focus (>85% severity)
- More than 25% highlights blown
- More than 25% shadows crushed

---

Configuration

Edit config/default.js to customize:

`javascript
export default {
// Scoring weights per mode
weights: {
general: { sharpness: 0.25, exposure: 0.25, ... },
landscape: { composition: 0.25, dynamicRange: 0.15, ... },
},

// Classification thresholds
thresholds: {
select: 72,
good: 58,
review: 45,
maybe: 30,
},

// Auto-reject conditions
autoReject: {
motionBlurSeverity: 0.85, // 0-1 scale
defocusSeverity: 0.85, // Only severe blur
highlightClip: 25, // More than 25% blown
shadowClip: 25, // More than 25% crushed
},

// Output folder names
folders: {
select: 'selects',
good: 'good',
review: 'review',
maybe: 'maybe',
reject: 'reject',
},
};
`

---

API Usage

`javascript
import {
analyzeImages,
organizeImages,
scanDirectory
} from './src/analyzers/imageAnalyzer.js';
import { searchFiles, getDirectoryStats } from './src/search/searchEngine.js';
import { findDuplicates } from './src/utils/duplicateDetector.js';

// Analyze images
const files = await scanDirectory('./photos', { recursive: true });
const results = await analyzeImages(files, { mode: 'general' });

// Access scores
for (const result of results) {
console.log(result.file.name, result.scoring.overall);
}

// Organize into folders
await organizeImages(results, './output', { copy: true });

// Search by EXIF
const searchResults = await searchFiles('./photos', [
{ type: 'iso', filterType: 'range', min: 100, max: 800 },
{ type: 'aperture', filterType: 'range', max: 2.8 },
]);

// Get statistics
const stats = await getDirectoryStats('./photos');
console.log(stats.stats.iso.average);

// Find duplicates
const duplicates = await findDuplicates(files, { method: 'hybrid' });
console.log(duplicates.stats.wastedSpaceFormatted);
`

---

Requirements

- Node.js: 18+
- ExifTool: Auto-installed via exiftool-vendored
- Disk Space: Temporary space for preview extraction

---

Troubleshooting

$3

---

License

MIT