Fotollection v0.1.0-beta.1

Added

• Best-shot suggestions (FR-041): Find best shots groups bursts and re-framings of one moment, then suggests the best photo of each group with up to three reasons ("34 % sharper", "Eyes open", "Less camera shake"). The Groups view shows each group as a strip, best first; Compare puts the shots side by side with a bar per measure and marks closed eyes. Keep best picks the suggestion and rejects the rest, for one group or all clear groups at once; for groups marked "Too close to call", choose with Keep this one. Nothing is deleted and everything is undoable. It runs offline on bundled face models, in about 17 ms per photo (28 ms with faces); results are cached, so a second run is instant. measure_folder --analyze measures it.

• Refresh folders (FR-001): a button next to the library's folders picks up photos added to them since, without re-importing; ratings, flags, crops and stamps are kept.

• Rotate photos (FR-006): turn a photo left or right with the buttons next to Crop in the preview, or with [ and ] in the grid and the preview. Lossless, the crop turns with the photo, undoable, and kept in the project (project schema v4). Upside-down selfies are fixed in one key press.

• Straighten (FR-006): a slider in the crop editor levels a tilted horizon by up to ±15°, with a fine grid while you drag; in crop mode ← → level by 1° (⌥ for 0.1°), and move between photos again once you leave it. The crop stays as large as possible without empty corners, and only the cropped pixels are resampled. Undoable, kept in the project (project schema v5).

• Print-quality audit (NFR-009): bench/quality/audit.py compares every exported pixel with the original. The export keeps the colour profile, full detail and saturation, with a mean ΔE2000 of 0.19, against a typical web-editor export that loses 87 % of the fine detail and 13 % of a P3 photo's saturation. Shown in both READMEs and in RESULT §9.

• The line under the date updates the preview while you type (a short pause after the last key), in the settings panel and in the preview.

• A photo's own date stamp (FR-044): in the preview, the stamp controls (on/off, format, place, the line under the date) now change the open photo only, marked This photo; Apply to all makes them the setting for every photo. The settings panel offers Reset for photos with their own stamp. Undoable, and saved in the project (project schema v3).

• Film-camera style imprint (FR-004, FR-005, FR-033, FR-036): the text inside the photo is now a slanted 14-segment LCD face (DSEG14 Italic, OFL) with the soft glow of an LED date imprint. Switch on Place on the date line to add the town from the photo's GPS ('25 09 21 DEBRECEN, offline; city, city + country code, or city + country), and type a line under the date that runs across the photo in plain capitals. The date sits a little higher, keeping the caption's row free. The stamp's font choice is gone (user fonts are for the info frame); settings move to v5.

• Fixed: the accent-folding table was misaligned, so some accented letters searched or printed as the wrong letter (for example "đ" as "c").

• Camera-brand logos in the info frame (FR-040): Apple, Canon, Fujifilm, Hasselblad, Leica, Lumix, Nikon, Phase One, Ricoh, Samsung and Sony logos come with the app (public-domain renderings from Wikimedia Commons; trademarks of their owners) and are picked from the EXIF make. Choose Classic (black wordmarks, colour accents kept), Brand colours or One colour; on a black frame, dark parts turn white. Wordmarks are sized to the frame text. Cameras still on the default typeset name switch to their logo once (settings v4); your own PNG and typed names are kept.

• Switching off the date stamp or the info frame now folds its options away, so the settings panel and the preview stay short.

• README (English and Vietnamese): system requirements for running and building, with measured memory and cache sizes.

• Rename a project in place (FR-023): double-click its name in the sidebar. A saved project's file is renamed in its folder (never over another file); an untitled project uses the name for its first Save. Enter saves, Esc cancels.

• The sidebar, now a little wider, and the README credit the author: "Fotollection by @hoangphi01".

• Better best-shot groups (FR-041): similar shots are now matched by layout and colour instead of a dHash, and re-shooting closer (zooming) no longer splits a group. On 95 hand-labelled photos the app now finds 15 of 22 groups instead of 3, still with no wrong group, and its suggestion was acceptable in all 6 groups with a clear best. A shot with the face turned away no longer wins on background sharpness. Analyses are recomputed once (cache version 2). The README shows the full evaluation.

• The library toolbar adapts to the space between the sidebars: button labels shrink to icons first, then the filters wrap to a second row, so nothing is cut off on smaller windows.

• HEIC import (FR-001): iPhone photos (HEIC/HEIF) open, preview and export like JPEG, with their EXIF date and GPS. They are decoded by the operating system (ImageIO on macOS; on Windows, the HEIF and HEVC extensions from the Microsoft Store). Without the Windows extensions, the skipped-files list says what to install.

• Project files like .docx (FR-023): File → Save / Save As / Open / New (Cmd/Ctrl+S, Shift+Cmd/Ctrl+S, Cmd/Ctrl+O, Cmd/Ctrl+N), also in the sidebar. A .fotollection file carries the edits, print settings, info frame, camera profiles and the fonts and logos it uses, so it opens the same on another machine. Copying the project together with its photos keeps working; moved folders can be relinked. The window title shows unsaved changes, New and Open ask before discarding them, and double-clicking a .fotollection file opens it. The menu and title follow the interface language.

• Vietnamese interface (FR-020): choose English or Tiếng Việt at the top of the settings panel; it applies at once and is remembered. Every label, hint and error message is translated, and numbers use the language's decimal separator (10 × 13,3 cm).

• The info-frame controls (on/off, crop or fit, colour, date format, font, shown items) are now also in the preview, so the frame can be tuned without leaving it.

• README in Vietnamese (README.vi.md, the VI link at the top) and a reworked Performance section: four charts, each with a reference line (budget, 2 GB ceiling, browser) and a table under it. Charts are generated in English and Vietnamese by bench/chart.mjs; bench/batch.sh reproduces the 5,000-photo memory check.

• Simplified logo tile (no wordmark) for the sidebar, favicon and every app-icon size up to 64 px, so the icon stays readable in the menu bar, taskbar and Finder lists. scripts/small-icons.py regenerates them.

• docs/RESULT.md: the latest measured speed and memory in one page, including a 5,035-photo batch (peak 1.47 GB, flat versus 95 photos). measure_folder gains --inflight N, --discard-output, per-phase RSS and a preview time breakdown.

• Original print size (FR-045): keep each photo's own aspect ratio with no crop (10 cm on the short edge, e.g. 10 × 13.3 cm for 4:3). Works with the date stamp, the info frame and the DPI check.

• Culling (FR-022): rate photos 0–5 stars and flag them pick/reject with 0–5, P, X and U in the grid or the preview, or click the stars and flags in the preview. Filter the library by flag and minimum rating; export writes exactly the filtered photos. Rejected photos are dimmed, never deleted, and every change is undoable.

• PNG import (FR-001): PNG photos and screenshots (8/16-bit, greyscale, palette) open, preview and export like JPEG. Transparency prints as white, and an embedded ICC profile is kept.

• docs/EXTENSION.md: registry of Fotollection's file types (project, preset, settings, fonts, logos, exports, inputs) with MIME types, UTIs, versions, limits and compatibility rules.

• Rust vs browser benchmark: bench/run.sh <photo-folder> measures export, preview and peak memory for the Rust core and for headless Chromium on the same photos, then draws docs/images/bench.svg for the README. Measured: export is a tie, the browser previews faster, and Rust uses 20% less memory and encodes 4:4:4.

• Crop editor: dims everything outside the crop, drag to move, wheel/pinch/slider zoom, arrow-key nudge, and a live label with the printed size in cm, pixel size and DPI band. Crops are stored as centre + zoom, so they survive print-size changes.

• Session project (FR-023): edits autosave atomically to an implicit project. The last session's folders are re-scanned and edits restored at launch. Undo/redo with Cmd/Ctrl+Z.

• Custom fonts (FR-042): import OTF/TTF, then choose them for the date stamp and the info frame. Files are validated and copied; removing a font falls back to Inter.

• Custom print sizes (FR-043): enter in cm or inches (e.g. 4 × 6 in), saved and usable everywhere.

• Crop editor edge labels (width on top, height on the left, in cm or in) and an aspect-ratio pill.

• The print-size picker shows each size's aspect ratio (10 × 15 cm · 2:3, 4 × 6 in · 2:3).

• settings.json schema v2 with automatic migration from v1.

• Info frame ("Shot on …", FR-040):

  • A white or black bar with the brand, camera, lens, focal length, aperture, shutter, ISO, photo style and date.
  • The whole print keeps the selected size, with the photo cropped to fill or fitted whole.
  • Every item can be switched on or off, LUMIX Lab style.
  • Per-camera overrides for manual lenses, names and styles, remembered across sessions.
  • Optional user PNG logo per camera (ADR-0014).

• settings.json, the first persisted file: render, frame and camera profiles, versioned and written atomically (DATABASE.md §6).

• EXIF now reads the lens, focal length, aperture, shutter and ISO.

• First working slice (JPEG):

  • Open a folder (or drop it on the window) to get a virtualized thumbnail grid with instant EXIF thumbnails.
  • Preview the exact print: centred crop for 8 print sizes, and a date stamp (3 formats, 4 corners, white or retro orange) inside the safe area.
  • Export at full resolution to YYYY-MM-DD/ folders, with progress and cancel, never overwriting files and never writing GPS.

• Rust core: import validation (magic bytes, size, polyglot), allowlisted EXIF, columnar library, JpegCodec trait with pure-Rust codecs (ADR-0012), render plan, T0/T1 thumbnail cache, T2 preview LRU, bounded parallel export.

• Print preview dialog with an inspector: capture time and source, camera, pixel and file size, GPS, effective print DPI with a quality band (FR-026), crop mode, and quick stamp controls.

• Loading feedback: skeleton and spinner thumbnails that fade in, plus a progress bar with percentage for reading photos and preparing thumbnails (task-progress event).

• Typed IPC events (library-changed, thumb-ready, export-progress, export-finished) and the fotothumb:// image protocol.

• Phase 0 scaffold: a Cargo workspace (fotollection-core + the Tauri 2 shell), and a React + Tailwind + shadcn/ui + Lucide UI shell (library sidebar, empty state, print-settings panel) with typed IPC through tauri-specta.

• Retro app logo and generated platform icons.

• CI: build, lint and test on macOS and Windows; stale-bindings check; cargo deny, npm audit and DOM-API security gates.

• Reproducible machine setup: scripts/bootstrap.sh / bootstrap.ps1, pinned Rust toolchain and Node version, committed lockfiles.

• Documentation framework: PRD, architecture, optimization, style rules, security, testing, release, roadmap, status, glossary, and ADRs 0001–0007.

• LICENSE: GPL-3.0-only (ADR-0008). Distribution policy: unsigned builds with checksums (ADR-0009).

• docs/DEVELOPMENT.md and scripts/clean.sh, a tiered cleanup of build artifacts (sweep, release, full, deep).

• Docs CI: markdownlint, link check, and the requirement-ID consistency check (scripts/check-docs.sh).

Changed

• Releases (ADR-0021): one version for the whole app, following Semantic Versioning (0.x until the MVP is complete). scripts/release.sh prepares a release commit; when it reaches main, CI builds the macOS (universal) and Windows installers and publishes them on GitHub Releases with checksums and first-launch steps. There is no in-app updater: the app stays fully offline and shows its version in the settings panel (FR-021).
• Print-size advice (FR-026): under the print-size picker, one sentence tells how large the selected photo prints sharp and still acceptable ("6240 × 4160 px (26 MP): sharp up to about 35 × 53 cm, acceptable up to 70 × 106 cm"), and every size in the list carries a badge: green Sharp, yellow Acceptable, red Pixelated.
• Website: https://hoangphi01.github.io/fotollection/ (English) and /vi/ (Vietnamese), with download buttons for the latest release, screenshots of the real app on CC0 demo photos, three benchmark charts, link previews and no third-party scripts or fonts. Its colours come from the logo: a cream background, teal, wood and leaf green.
• The Vietnamese place-format buttons are shorter ("Thành phố", "+ mã nước", "+ tên nước"), so they no longer overflow the settings panel.
• Previews are faster: 26 → 17 ms, now faster than the same work in Chromium. On-screen JPEGs (previews, thumbnails) use 4:2:0 and plain Huffman tables; exported prints keep 4:4:4 and optimized tables.
• Thumbnails no longer wait behind background work: there are separate interactive and background pools, and the core is optimized in dev builds.
• CSP now allows inline styles (scripts stay strict) so Radix overlays work in release builds (ADR-0013).
• New docs/DATABASE.md: the single source of truth for persisted data, with a normalized (3NF) data model (integer keys, one fact in one place, sparse delta rows, no derived data on disk), columnar in-memory layout (~42 B per photo), project-file schema v1, migrations, atomic writes, the preset model, the thumbnail cache, and criteria for adopting SQLite.
• PRD: FR-038 (Lightroom-style partial, stackable, linked print presets with .fotopreset sharing) and FR-039 (Photo Style looks modelled on Lumix GX9, including a built-in "C200 Natural"). ADR-0011 sets the scope boundary (global looks only).
• PRD expanded with 16 requirements (FR-022…FR-037) covering culling, projects with undo, mixed print sizes, resolution warnings, sRGB conversion, safe area and borders, clock correction, GPS borrowing, manual date and place, a retro LED date stamp, lab presets, captions, multi-photo layouts, sharpening and contact sheets. Also NFR-012/013 and ADR-0010 (project file format).
• Project renamed from PhotoOrder to Fotollection.
• Direction changed from a browser web app to an offline Tauri 2 desktop app with a Rust core (ADR-0001).
• UI stack changed to React, shadcn/ui and Lucide (ADR-0007).

Removed

• PLAN.md. Its content was split into docs/PRD.md, docs/ARCHITECTURE.md and docs/ROADMAP.md.

Install

Fotollection is free and works offline. The installers are not signed with a paid certificate yet (why), so the first launch needs one extra step:

• macOS 11 or later (Apple Silicon and Intel): open the .dmg and drag Fotollection to Applications. On the first launch macOS blocks it; open System Settings → Privacy & Security and click Open Anyway.
• Windows 10/11: run the -setup.exe (or the .msi). If SmartScreen says "Windows protected your PC", click More info → Run anyway.

Installing over an older version keeps your settings, camera profiles and projects. Check a download against SHA256SUMS.txt with shasum -a 256 <file> (macOS) or certutil -hashfile <file> SHA256 (Windows).