diff --git a/README.md b/README.md index 2bc1af2..22926c3 100644 --- a/README.md +++ b/README.md @@ -958,22 +958,24 @@ A **local, offline-first** focus-stacking application (Zerene/Helicon class) for ### Workflow stages -0. **Camera** — remote capture from OM System / Olympus Wi-Fi cameras: BLE wake-up, live view with tap-to-focus, remote trigger of in-camera Focus Bracketing, auto-download of the new ORFs. +0. **Camera** — remote capture from OM System / Olympus cameras over USB or Wi-Fi. Wi-Fi does BLE wake-up, live view with tap-to-focus, a remote Focus Bracketing burst, and auto-download of the new ORFs. USB needs the body's USB Mode set to RAW/Control. That tether works on macOS and Linux; Windows cannot open it, because the in-box MTP driver owns the camera. 1. **Import** — `.ORF` and other RAW/TIFF/JPEG; instant previews from embedded JPEGs; Olympus `FocusStepCount` ordering and duplicate curation. 2. **Align** — phase-correlation seeding (with a log-polar rotation/scale search) and a chained pyramidal ECC-style fit. The default model is a 4-DOF similarity; a 6-DOF affine is available. The chain is adjacent pairs, then a capped drift correction against the reference frame. 3. **Mass crop** — auto intersection rect of all aligned frames, adjustable on the master; "Crop" bakes warp+crop into every frame so no border replication reaches fusion. 4. **Stack** — the picker offers Fine Detail (Laplacian pyramid), Depth Aware (depth map), Edge Detail (complex wavelet), Balanced (Spiker), Sharp Regions (Patch), Adaptive (Hybrid), Max Contrast (PMax), Depth Pro (DMap), Soft Average, Depth Standard, Depth Legacy, Contrast Classic, and Studio Soft. A new session starts on the top of the user's own ranking, or Fine Detail when there is none. 5. **Touch up** — dual synced previews (source frame | fused result). The brush is Details, Clone, Darken, or Lighten at full 16-bit resolution, with per-stroke undo. -6. **Finish** — denoise, Richardson–Lucy deblur, optional 2× super-resolution, and halo-limited sharpen, then an optional subject-on-black matte. -7. **Export** — 16-bit TIFF, JPEG, PNG, or AVIF. A session saves as a ZIP `.sstack` (`manifest.json` plus the rasters); older JSON `.sstack` files still open. +6. **Finish** — denoise, Richardson–Lucy deblur, optional 2× super-resolution, and halo-limited sharpen, then an optional subject-on-black matte. Previews and exports go through a display profile: Camera (the default, from the reference frame's Picture Mode), Natural, Vivid, Muted, Portrait, Monochrome, or Linear. On macOS, Open in Topaz Photo hands the plate to Topaz Photo. +7. **Export** — 16-bit TIFF, JPEG, PNG, or AVIF, or an Instagram-framed H.264 pan video. A session saves as a ZIP `.sstack` (`manifest.json` plus the rasters); older JSON `.sstack` files still open. ### Architecture -A Rust workspace. The desktop app is four crates: `stacker-core` (the pipeline — no UI deps; RAW decode through the runtime `rawbridge` library, so `rawler` is not linked into the binary; `rustfft`, `rayon`, `memmap2`), `stacker-gpu` (**wgpu** compute kernels from one WGSL codebase targeting Metal/Vulkan/DX12, with a CPU fallback for every kernel), `stacker-camera` (PTP/IP on the home network and Olympus Wi-Fi CGI, UDP live view, optional BLE wake, plus a mock camera for tests), and `stacker-app` (egui/eframe desktop UI). The workspace also builds `stacker-mobile` (UniFFI), `uniffi-bindgen`, `rawbridge`, and `rawbridge-abi`. +A Rust workspace. The desktop app is four crates: `stacker-core` (the pipeline — no UI deps; RAW decode through the runtime `rawbridge` library, so `rawler` is not linked into the binary; `rustfft`, `rayon`, `memmap2`), `stacker-gpu` (**wgpu** compute kernels from one WGSL codebase targeting Metal/Vulkan/DX12, with a CPU fallback for every kernel), `stacker-camera` (PTP/IP on the home network, a USB tether, and Olympus Wi-Fi CGI, UDP live view, optional BLE wake, plus a mock camera for tests), and `stacker-app` (egui/eframe desktop UI). The workspace also builds `stacker-mobile` (UniFFI), `uniffi-bindgen`, `rawbridge`, and `rawbridge-abi`. **Trial, then a licence.** Every stage works offline. The first 30 days are a trial: the "QR S · SpikerSoft" mark, a code pointing at `spikersoft.com/stacker` (never at donations), is optional. After the trial, without a licence, a stack holds at most 15 images and that mark is burned onto exports. A one-time licence (US$39.99) bought at [spikersoft.com/stacker](https://www.spikersoft.com/stacker#buy) removes the cap and the mark. **Account → Sign in with spikersoft.com** (the website's Keycloak SSO session, via a loopback PKCE flow) picks up a licence bought on the account and unlocks **Publish to spikersoft.com** (source frames + finished stack with provenance and Darwin Core identification into the user's gallery, optional blog post, optional public share page at `/p/{token}`). The public [`/stacker`](https://spikersoft.com/stacker) page lists per-platform installers proxied by `api.spikersoft.com` from the repo's rolling Gitea Release (`latest`). -Beyond publishing, the app is self-contained: no S3 client, and every pipeline stage runs locally. It is the platform's only stacker since 2026-09-25 (the in-browser Photo Stack lane and its artpipe model were retired). +A key shaped `SSK-XXXX-XXXX-XXXX-XXXX`, pasted under Settings › Account › Enter license key, unlocks the app without signing in. The licence is leased for 90 days. The app asks for a fresh lease every 30 days and keeps working offline in between. Settings › General sets the language to English or one of 15 translations, or follows the system language. Help › Check for Updates reads the same download feed as the public page, checks the file's sha256, then on macOS replaces the running app; Windows and Linux open the downloaded installer. + +Beyond publishing, the app is self-contained: no S3 client, and every pipeline stage runs locally. The in-browser Photo Stack lane and its artpipe model were retired on 2026-09-25. The iOS and Android Focus Stacker apps fuse brackets on the phone; this desktop app is the full offline pipeline. --- @@ -1518,6 +1520,7 @@ dotnet test --filter "Category!=Integration" # Skip tests tagged Category=Integ | Native mobile apps | `spikersoft-ios` / `spikersoft-android` | | Godot client | `spikersoft-games-godot` | | Rust game engine | `spikersoft-gaming-engine` | +| Desktop focus stacker | `spikersoft-stacker` | **There is no central tracker.** `spikerj/spikersoft-issues` was retired on 2026-08-07 and now holds this README only — do not file there. @@ -2699,6 +2702,7 @@ Licensing is **not uniform across the monorepo**; use the SPDX / files in each p - **Angular app** ([`spikersoft-angular/package.json`](spikersoft-angular/package.json)): `"license": "AGPL-3.0"`. - **Backend** ([`spikersoft-backend/README.md`](spikersoft-backend/README.md)): that file says there is no `LICENSE` in the repository. [`SpikerSoft.sln`](spikersoft-backend/SpikerSoft.sln) still names `LICENSE.md` as a solution item, but the file is not in the tree, and the repo states no license. - **Gaming engine** ([`spikersoft-gaming-engine/Cargo.toml`](spikersoft-gaming-engine/Cargo.toml)): `"license": "LicenseRef-Proprietary"`. The crates are not published. +- **Desktop Stacker** ([`spikersoft-stacker/Cargo.toml`](spikersoft-stacker/Cargo.toml)): `"license": "LicenseRef-Proprietary"`. The crates are not published. RAW decoding stays in a separate `librawbridge` so the LGPL-2.1 `rawler` library can be replaced (`LICENSE-THIRD-PARTY.md`). Earlier text here referred to an “Academic License” and a single `LICENSE` at repo root — **there is no shared root license file in this workspace layout**; rely on the paths above.