Shutter Killer

Local-first photo organizer — browse, filter, and curate photos entirely in your browser. No backend, no upload, no account.

中文说明

Features

• 100% client-side — photos stay on your machine (File System Access API)
• EXIF, colors, local ONNX classification
• Filters — favorites, category, location, date, color
• Lightbox — navigation, EXIF, magnifier
• Similar photos — duplicate / burst detection
• Metadata — sk-meta.json written next to your files

Quick start

Requires Node.js 18+ and a desktop Chromium browser (Chrome / Edge).

git clone https://github.com/lemondepat/shutter-killer.git
cd shutter-killer
./setup.sh
./serve.sh          # http://localhost:5001

Open the URL, choose a photo folder, and start.

Use ./serve.sh (local HTTP). Opening index.html via file:// will not work.

Development

npm install
npm run dev       # static server + JS watch/rebuild
npm run build     # static/js → static/bundle.min.js

Path	Role
index.html	App shell
static/js/	Source
static/bundle.min.js	Built bundle
static/models/	ONNX classifiers

Deploy

Static hosting only (GitHub Pages, any CDN):

npm run build
# ship: index.html, sw.js, manifest.json, icon.png, logo.png, static/

License

MIT · Contributing

---

中文

纯前端本地照片整理工具，照片在浏览器处理，元数据写入目录内 sk-meta.json。

./setup.sh && ./serve.sh

无需 Python，无需登录或上传。