Repository navigation
Releases
PhotoStore 0.20.8 — Compact video previews and timeline controls
PhotoStore 0.20.8 adds compact native video previews, row volume controls and editable timeline lengths. Source: 575913fc4de5bb27d5b7234629d7ed7ad90034f1.
Performance acceptance pending: #23 remains open. Both online displays report asleep, and a PID-specific activation request left the owned test app inactive. The final eight-source 3840×2160 H.264/30 fps native window run averaged 24.28 fps with live-brush publication gaps (maximum 365 ms), despite idle/panning phases around 30 fps and sampled UI construction p95 below 1 ms. This is an implementation release, not verified foreground smoothness or CapCut parity. Active-display playback, physical pen routing/scanout and audio-device acceptance remain manual.
- Eligible opaque SDR H.264 frames stay full-resolution NV12 through the bounded cache and GPU stack, including a lone video. Existing transfer/color handling and original-quality export remain authoritative; unsupported media/effects use raster fallback.
- Bounded cooperative copies reuse the existing upload helpers. Decoding, live preview composition and texture retirement run away from input; publication uses the native renderer callback. Thumbnail jobs have separate small cache identity and a background worker, with new thumbnail work suspended during playback.
- Compact per-row dB/mute controls persist independently from clip gain. Preview/export multiply both, and legacy linked rows separate by owner without flattening relative clip levels.
- Drag timeline clip edges for videos, images and Smart Objects. Extend Clips to Timeline End fills available time while respecting movie source bounds.
- Timeline end follows surviving content after timing edits. Explicit Duration/Add 5 seconds reserves extra tail time; growing content consumes it, shrinking content preserves the remaining reservation, and Fit Timeline to Content removes it. Off-clip keys/markers are retained and undo/save/reopen preserve them.
- Fix embedded Smart Object timelines retaining unrelated sibling track memberships. Fix compact-frame identity checks incorrectly blocking painting on a separate drawing layer.
Focused final-source checks passed: lone-video compact GPU path; brush commit and saved pixels; paused future staging preserves current/history; gain/link/mute/default compatibility; trim/extend/extra-time/Smart Object/undo/save/reopen/source-bound preservation. Four native GPU texels matched the original-quality CPU render within one 8-bit value. These checks use disposable owned fixtures and synthetic egui input, with no screenshots or private artwork.
Normal production identity: PhotoStore, ai.photostore.app, /Applications/PhotoStore.app. The already-built and verified app/CLI artifacts are uploaded without rebuilding, then the same app is atomically reinstalled. A running session may keep its loaded version until restart; rollback bundles and recovery/preferences are preserved. Local CI stays disabled, unloaded and without pending jobs; publication triggers no development/production build.
Signed with the persistent local certificate; not Developer ID/not notarized. SHA256SUMS accompanies the assets. Delivery evidence and limits. Original GPT Image workflow/duration designs and exact prompt/provenance records are under docs/design/2026-11-02/; they are mockups, not product screenshots.
PhotoStore 0.20.7 — Stable preview and input
Fixes the remaining timeline jitter/buffering, Space-drag and pen popup source issues (#23, #30, #31).
- Fixed-size preview status prevents toolbar/ruler movement during buffering.
- Paused video refresh uses the background presentation worker; completed preparation wakes the event loop, and transport overlaps the next preparation.
- Hidden/ancestor-hidden/out-of-time/muted media no longer decodes or blocks visible readiness.
- Forward playback fills the existing bounded near-playhead decode window during asynchronous preroll, capped at 150 ms before starting its clock/audio. Seek remains current-frame-only.
- Identity movie presentation avoids repeated pixel-bound scans; already-correct RGBA8 decode returns without a tile-map clone. Shared-buffer tile-copy batches let the compositor caller participate immediately with up to three ready helpers; only real copies are counted, so idle-helper wakeups are outside the critical path. Row-repacking retains parallel workers.
- Stable bounded decoder affinity and four reusable raw buffers reduce process and allocation churn. Missing-current jobs take priority; bounded lookahead yields only to urgent work on its servicing worker, and queued prefetch is promoted when the playhead reaches it.
- Eligible axis-aligned linked video reductions decode at their placed preview size, avoiding full-source CPU warps. Original source placement/data and full-quality output remain authoritative.
- Late Space gestures cannot jump from an old pointer origin or steal a live stroke. Pen secondary press routing uses its delivered position/topmost layer without requiring preceding hover.
One bounded production-CLI measurement used eight distinct original 3840×2160 SDR H.264/30fps sources for 90 paced frames on the local hardware compositor. All eight sources yielded 90 distinct sampled hashes, properties/history/clean state remained intact and sampled GPU pixels passed the CPU reference comparison. Warm completion lateness p95: 0.702 ms; 2 of 89 warm deadlines exceeded 5 ms. The same forward-start lookahead policy is counted in cold preparation (69.987 ms, window ready: True, cap 150 ms). This excludes native egui/window scanout, input and audio-device output. It does not establish CapCut parity or arbitrary-codec throughput.
The signed final CLI also passed focused native save/reopen/frame-advance/source-preservation/rasterize checks. Native UI/pen acceptance remains manual; no screenshots, live GUI recording or discretionary suite was run.
Exact binary source 7c17226b4e0989a55a32c963ae4f39b63afd1054. Same verified ARM64 app/CLI artifacts are published and atomically installed with the normal identity. Running documents/session and rollback copies are preserved; restart manually when convenient. Local persistent certificate, not Developer ID/not notarized. Scheduler remains disabled/unloaded with no pending replay; publication triggers no build.
Delivery, source decisions and limits · Built-in GPT Image design/provenance
PhotoStore 0.20.6 — Video transform and responsive timeline
Fixes video transform, Space transport and the redundant Media sidebar (#36, #37, #38), plus native buffering architecture in #23.
- Active Free Transform owns pointer drags before Zoom/Rotate View. Static video placement persists across frames and native save/load without replacing originals; rasterizing retains the placed appearance. Invalid transform footprints are rejected. Transformed video caches cannot be painted back into original frames.
- Space plays/pauses active video timelines from ordinary panels and controls; actual drawing-canvas focus retains hold-Space panning. Text entry and modal controls keep their keys; repeats do not retrigger transport.
- Removed the separate Media/Import sidebar. Source relink, replacement, reload and rasterize are available through Layers/context actions; existing Place and file drop remain.
- Native presentation preparation, private-resource GPU composition/CPU fallback and audio mix scanning/device/process lifecycle run on bounded background workers. The UI retains a complete canvas while preparing another. Generations reject stale edits/seeks and late audio startup. Initial preroll waits for complete canvas/audio readiness.
The production CLI passed a focused data-safety check on owned synthetic footage: placement survives frame advance and native save/reopen, original frame tiles/file bytes are preserved, and rasterize yields identical placed pixels. Native pointer/focus/display/audio-output acceptance remains manual. No new FPS or native latency measurement is claimed; the earlier 0.20.5 benchmark is historical. Other codecs, effects and transformed workloads remain hardware-dependent.
Exact binary source e06c8ae5d66db99bf43b76a3a91b2f9b9c5a6508. The same locally built, verified ARM64 app/CLI artifacts are published and atomically installed with the normal PhotoStore identity. Running app/documents are preserved; restart manually when convenient. Local persistent certificate, not Developer ID/not notarized. Scheduler stays disabled/unloaded with no pending replay; publication triggers no build.
Implementation and delivery record · Built-in GPT Image design/provenance
PhotoStore 0.20.5 — Concurrent 4K playback and compact audio
Video audio now occupies a thin waveform band inside each 48-point video row, with per-source mute. Standalone audio remains one compact editable row. A bounded texture cache reuses waveforms during playback.
Concurrent playback removes full-frame CMS/tile copies, copies whole tiles into the native shared mapped uploads, fuses eligible two-to-eight-source RGBA8 Normal stacks into one FP32 pass per chunk, and uses a host-sized worker pool under the existing shared retained-memory budget and eight-session ceiling. Eligible Apple Silicon video stacks address tile-major RGBA directly from shared GPU buffers; unsupported stacks and devices retain the texture path. Eligible Apple Silicon opaque H.264 4:2:0 previews use FFmpeg VideoToolbox decoding with a bounded software fallback at the next exact timestamp. Decoded output still crosses a bounded RGB24 pipe into CPU tiles; this is not zero-copy decode to Metal. Large movie surfaces avoid redundant exact bounds scans. Opaque 8-bit H.264 carries RGB24 through a smaller pipe and reconstructs RGBA tiles directly; other codecs retain RGBA. Video pre-roll waits for the starting frame's canvas completion before starting audio and anchoring the clock; stop/seek/rebase replace readiness signals.
On Apple M1 Max / 32 GiB, eight distinct original 3840×2160 SDR H.264/30 fps streams completed at 31.04 timeline frames/s through PhotoStore's hardware wgpu compositor. A paced 180-frame/30 fps run had 1.600 ms p95 completion lateness and 5 deadlines over 5 ms. Every source yielded 180 distinct sampled hashes. Authored opacity/visibility and history/clean state were preserved; final sampled GPU pixels matched CPU reference, and the full decoded reference frame retained identical encoded tiles. No resolution downgrade.
These are headless original-resolution GPU-completion measurements, excluding native window scanout/input/sound-device output. They do not establish universal CapCut parity. Native acceptance remains manual; other codecs/effects/precision or more sources may perform differently. Accounting is not a total process/codec/GPU memory cap. photostore-cli playback-bench exposes the scoped measurement.
Exact binary source: 621e2401b1035b922b66576e9a6425fc6ca9b067. One completed local normal app/CLI build; same verified artifacts are published and immediately atomically installed. Running documents/session are preserved; restart manually when convenient to load the new code. ARM64, locally signed with the persistent PhotoStore certificate; not Developer ID/not notarized. Scheduler stays disabled/unloaded with no pending replay. Publication triggers no build.
Implementation, evidence and limits · Architecture plan · GPT Image design/provenance
PhotoStore 0.20.4 — Layered media playback
Timeline rows follow the Layers panel stack. Plain opacity edits persist across overlapping video playback instead of being reset by old frame snapshots.
Movie audio belongs to its source layer, including legacy shared-track presentation. Standalone audio imports/File Open create lightweight document layers; copy, delete, undo and native roundtrip preserve ownership. Source audio has independent mute/gain and authored visibility/range handling.
The bounded decoder pool reuses up to eight accounted sessions with two active request workers. Two and six original-resolution synthetic 4K source paths each delivered all 60 changing frames per source, with authored opacity preserved and respectively two/six decoder launches (no per-frame restarts). Warm headless preparation: 54.9 and 21.7 timeline frames/s. Six full-resolution sources remain below a 30 fps preparation target. These measurements exclude GPU composition/display/audio output and do not establish native playback FPS or CapCut parity; #23 remains open.
Focused shipped-CLI ownership, stale-opacity and untrusted filesystem-permission boundaries passed. Native UI/audio acceptance remains manual. Different-project-rate destination copies with speed curves require equal project rates.
Built once successfully from exact source 9fa1ffb6f38b70e4b3ec9ebdb5ba4203ef086cf5 after correcting initial compiler integration errors. Normal ARM64 app and CLI use the persistent local PhotoStore certificate, not Developer ID/not notarized. Only these prebuilt artifacts are published and installed; no push/tag/release build trigger.
See release evidence and architecture. Fixes #33, #34 and #35; #23 retains wider native/performance acceptance.
PhotoStore 0.20.3 — Layer and canvas workflows
PhotoStore 0.20.3 improves layer copying, dropped movies and canvas input.
- Cmd+R directly duplicates selected layers in the same document. On macOS, Cmd+Ctrl+R opens Copy Layer with destination document, insertion layer and optional name. Cmd+Shift+R retains Lens Correction. Rulers moves to Cmd+Alt+Shift+R; the conflicting timeline speed-inspector default is unassigned. Explicit custom key assignments are preserved.
- Dropping video onto an open document adds an editable linked video layer there. Its preview stays static until explicit Video Timeline creation, with deferred source/audio intent preserved across native save/reopen. Existing Video timelines receive playable ranges/audio. Queued imports retain the original destination DocId. Explicit File Open and tab-strip drops keep their existing paths.
- Space+drag updates the camera before drawing and tracks movement from the actual press; canvas navigation no longer toggles timeline transport or repeats playback toggles while Space is held.
- Brush/Pencil/Eraser secondary-button press opens the existing picker immediately, so hover jitter cannot cancel a release-classified click. Resize/erase/layer-pick gestures are preserved, and the opening press cannot dismiss the picker or leave a stray paint gesture.
Two focused headless data checks passed: deferred video save/reopen/static Frame Animation/atomic Video activation/audio/ranges/work area/undo; and source-preserving same/cross-document layer copy with valid catalog identities, placement and undo. The production app/CLI build is the UI compiler pass. No broad QA, live app capture, physical shortcut/OS-drop or Cintiq-driver verification was performed. Native pan feel and Wacom responsiveness remain for manual acceptance; the code handles delivered secondary events without changing driver profiles.
Exact binary source: e7de47f6b1103ee32f8bbb6b06daee8054c04473. One local ARM64 production app/CLI build; attached assets are the verified local packages. Persistent local PhotoStore signing certificate, not Developer ID/not notarized. Publication triggers no build. Running sessions and rollback copies are preserved during normal-app installation; reopen PhotoStore when ready to load the new binary.
PhotoStore 0.20.2 — Smooth preview cadence
PhotoStore 0.20.2 corrects a preview cadence defect found in 0.20.1: timestamp rounding repeated every third frame of a 30 fps source. Preview now preserves complete rational cadence while retaining VFR held-frame sampling.
The scalability work is retained: persistent decoders with immediate bounded frame publication, shared pixel tiles and animation banks, cheap pending presentation, playback-aware thumbnails, and adaptive derived caching. Fixed 64 MiB timeline conversion/Make Frames From Layers/tween gates use configured Memory Usage, cancellable background jobs and atomic undo. Editable layers, drawing tools, Smart Objects and original-source exports remain authoritative.
Signed production CLI evidence on Apple M1 Max / 32 GiB, SDR H.264:
- 1080p: 1.50 ms warm p95, 318.76 prepared frames/s, all 180/180 distinct fixture frames, 1 decoder.
- 4K: 13.90 ms warm p95, 83.89 prepared frames/s, all 180/180 distinct fixture frames, 1 decoder.
Same blocking exact-seek comparison against 0.20.0 (five noninitial requests each): 1080p 640.39 → 102.86 ms; 4K 1929.93 → 156.16 ms. These are headless core preparation measurements, not native GPU/display/input/audio FPS or CapCut parity. Full-frame original comparisons passed at 30 and 30000/1001 fps, including seek/tail, VFR gaps and earlier targets, in addition to eleven prior scalability/data-boundary checks. The untrusted file-measurement permission boundary passed on the shipped CLI.
Native workflow acceptance remains pending in #23. Distinct recording/archive, configurable load and 64-megapixel Smart transform guards remain documented. Video retains its 8-bit intermediate; unsupported HDR fails explicitly.
Exact source 018567faf9ed2f2e181f6d05dc74ff6dd5542ffb. One local ARM64 app/CLI production build; already-built verified artifacts are attached. Persistent local PhotoStore signing certificate, not Developer ID/not notarized. Publication triggers no build.
PhotoStore 0.20.1 — Faster timeline playback
Known cadence defect: Inspection after publication confirmed a repeated-frame sequence (0,1,1,3,4,4,…) in 30 fps preview from nanosecond timestamp rounding. Latency measurements below do not establish complete frame cadence. A corrected follow-up is in progress; #23 remains open. Original media is unchanged.
PhotoStore 0.20.1 improves timeline playback and scalable animation authoring while preserving editable layers, Smart Objects, drawing tools and original-source exports.
- Reuse sequential video decoders and publish frames immediately; avoid repeated identity-format conversion and pending document copies.
- Share pixel tiles and animation snapshot banks across playback/history. Keep thumbnail work out of the playback path and drive timeline indicators from the transport clock.
- Remove fixed 64 MiB timeline conversion, Make Frames From Layers and tween rejection gates. Use the existing Memory Usage allowance, cancellation and atomic undo. Derived caches adapt to the configured allowance and host RAM.
- Preserve the native v3 wire format and exact source/export/proxy boundaries. Restrict file-based performance diagnostics to trusted local use.
On an Apple M1 Max / 32 GiB host, the signed production CLI prepared 180 H.264 frames with warm p95 1.46 ms at 1080p and 12.16 ms at 4K, using one decoder per run. The identical blocking exact-seek comparison improved from 640.39 to 99.20 ms and from 1,929.93 to 152.07 ms (five noninitial requests each). These headless measurements exclude native GPU/display/input/audio output and do not establish CapCut/native playback FPS. Eleven focused critical checks passed; native workflow acceptance remains pending in #23.
Distinct recording/archive, codec/load and 64-megapixel Smart transform safeguards remain documented. The decoder retains its 8-bit intermediate; unsupported HDR still fails explicitly.
Exact binary source: 72a4ddd131273357ce81a76af52c3abc8706e4ba. ARM64 app and CLI built locally once, signed with the persistent local PhotoStore certificate (not Developer ID/not notarized). Attached assets are the verified local artifacts; publication triggers no build.
PhotoStore 0.20.0
PhotoStore 0.20.0 addresses movie playback freezing while the timeline advances and completes the source/media architecture for #23.
- Exact-frame presentation holds a decode request until ready, then catches up to the transport clock.
- Shared source IDs, revision-aware relinking and insertion, rational project FPS and v3 native persistence with v1/v2 migration.
- Bounded shared derived caches (256 MiB), prioritized decoding and optional half/quarter disk proxies (maximum 10 GiB).
- Native 48 kHz sample-clocked audio when supported, with streaming external-player fallback.
- Editable Smart Object affine animation conversion, sample-aligned linked audio cuts, original-source export and pixel materialization.
- Tagged SDR video handling, explicit MP4 alpha background choice, and actionable errors for unsupported HDR conversion.
The 256 MiB budget covers retained derived caches, not total process memory. The video decoder retains an 8-bit intermediate. Older apps cannot open v3 archives. Native visual/interaction/audio-device acceptance and measured performance targets remain pending; no full Photoshop/CapCut parity is claimed.
Normal Apple Silicon macOS app and CLI. Signed with a persistent local PhotoStore certificate; not Developer ID and not notarized. Recording stays off and the local build scheduler stays disabled.
See implementation and delivery record and architecture details. SHA256SUMS covers the downloadable packages.
PhotoStore 0.19.0 — Timeline workflow and issue fixes
PhotoStore 0.19.0 brings the timeline overhaul and the seven-issue implementation inventory into the normal macOS app.
- Compact video workspace with explicit modes, selected-clip inspector/keyframes, readable lanes and labels, adaptive ruler, and visible-range thumbnails/waveforms.
- Explicit ripple deletion with atomic lock/bounds guards, preserved keys and linked audio, and one-step undo.
- Shared presentation-time movie sampling; prioritized/coalesced canvas requests, independent nested Smart Object requests, and cached source probe metadata.
- Timed brush smoothing correction, PSD/PSB timelapse metadata, app-switch cursor recovery, layer/group rename clipboard routing, and brush decrease down to 1 px.
- Required GPT Image design/provenance workflow; routine local installation now overwrites the normal PhotoStore app.
Source: 8aaacce50eccee3eb6d6261b21910cce7fe32545.
The ARM64 app and CLI are built once from this exact source. Packaging, publication, and local installation reuse those binaries. The focused ripple data-preservation regression passed 1/1; a tiny local FFV1 fixture verified held-frame sampling at four timestamps. Native mouse/tablet input, Photoshop round trips, and timeline visual/interaction/export acceptance were not manually performed. No screenshots, computer use, browser sweeps, broad QA, measured performance targets, or full Photoshop/CapCut parity are claimed.
Signed with the persistent local PhotoStore certificate; not Developer ID and not notarized. Perspective/warp animation, Smart Transform baking to Frame Animation, a new rational-time persistence format, disk-proxy controls, and a unified process-memory budget are not shipped in this release. The detailed implementation and delivery record is in the repository.
Related issues: #20, #23, #24, #25, #26, #27, #28.
Artifact checksums
| Asset | Bytes | SHA-256 |
|---|---|---|
photostore-0.19.0-macos-aarch64.dmg |
45,120,357 | 803228c27c30b7a1d017de095aa235d158356362d77c6dd28ccc240d002655f3 |
photostore-cli-0.19.0-macos-aarch64.zip |
32,266,714 | 1a8fe5a785f99ea57c0cc1363e4333a63b334fcd2ca4378a05d31ad4c4e8b401 |
The final DMG was created with an explicit 512 MiB APFS volume after automatic sizing exhausted its temporary image. Legacy hdiutil verification returned EAGAIN; the supported DiskImages2 info/read-only mount, strict DMG and mounted app/resource signatures, CLI ZIP integrity, and source/version/architecture checks passed. No compiler rebuild was performed.