Repository navigation
Sprite H3 v0.1.0 (alpha)
Pre-releaseThe first release of the redesign around Character Builds: every character has a matrix of
actions × facings, each cell is a slot you fill with frames from any run, and Freeze packs the
slots into a hashed, immutable build. Still an alpha: unsigned Windows installer, catalog
rebuilt on first launch, no engine adapters.
Before you upgrade from v0.0.1: back up
%AppData%\app.sprite-h3.desktop\and write
down any custom motions you added to the motion store. The catalog is rebuilt on first launch
and the motion store does not survive it (see Breaking changes).
What's new
Character page with a Build matrix. Actions × facings on one page, each cell a preview
strip that plays as a loop or lays out as a sheet, all matrices on one clock. Tabs for Settings
(sources, identity, actions, geometry, key colour), Runs and Builds. The separate Generation
page is gone: tick cells in the matrix, click a row or column header to tick the line, the
corner for everything missing, and a Generate N cells button opens a drawer with one editor
block per action, the gate chain and the request receipt before you submit. Ticking a cell of
a disabled action enables the action on validate.
Slots: pick frames from any run. Open a cell to see every candidate clip of that action and
facing across all runs of the character, use a whole clip, a review curation, or hand-pick
frames. Picks are pinned by content hash. The review page can write the slot directly (Save
and use in slot), so a fresh clip goes from review into the matrix in one step. A slot whose
frames disappear reads broken; a slot whose character geometry changed reads stale with a
reprocess offer; a slot you leave empty on purpose can be waived.
Freeze and builds. Freeze packs the current slots into a numbered build: per-action and
per-facing sprite sheets with metadata and contact sheets, copied frames, and a
character-build/1 manifest that hashes every file. Missing or stale slots are recorded as
skipped, not refused. Builds download as archives from the Builds tab; every file is re-hashed
against the manifest before an archive is served.
Stable action identity. Actions carry an id fixed at creation and inherited from the
template, so renaming an action keeps every run, override and slot attached. Runs from before
ids existed are matched by name; leftovers appear in an Unassigned row with Assign to…,
which writes a per-character alias file. Runs are never edited.
Templates that propagate. Template actions reach characters at load time instead of by
copy, so a template change shows on every character on the next load. Character overrides
shadow single fields.
Roster. All characters of a workspace grouped by template, each with its readiness per
template action, its newest build, archived characters included. A Check workspace button on
the workspace settings page lists characters of one template that disagree on cell size, feet
row or timing (warnings only; nothing is blocked).
Compare and views. Build a view of (character, action) rows and watch them play in lockstep
at normalized time, with a facing filter, hide-empty and transpose. Views are saved as files in
the workspace and listed on the roster. Same action across characters fills a view from a
roster column.
Downloads. Build archives per character, a newest-builds archive for the roster, a view as a
contact sheet, the preview strips of a view as a zip, per-run packs from the Runs tab. Every
download goes through the native save picker where the WebView offers one (the desktop app
does), a plain download otherwise.
Reference-aware delete and slim. Deleting or slimming a run lists the slots that stand on it
and asks once. Slim keeps the raw frames, curations, packed products and the preview strips, so
a slimmed cell still plays in the matrix.
Published contracts. JSON schemas for sheet-v3, character-build-v1, slot-v1 and
view-v1 plus the HTTP API as openapi.json under contracts/, generated from the models and
checked by a test.
Fixes since v0.0.1
- Row and column packs send the saved project geometry, so a cell resized after generation
packs at its current size instead of failing on the run snapshot (#1). - Key-colour warnings run the real key/alpha round trip with the project's matte and
thresholds; the panel shows the staged reference with a damage mask and names the matte (#2).
Distance is the default matte. - Review key quality uses the recorded matte, minimum alpha, chroma tolerance and alpha power
rather than the distance defaults, and reports which matte it measured with. - Switching facings no longer shows the previous facing's staged reference or mask.
- Slot reorder, verdict, strip, region, suggestion, warning and receipt glyphs are icons;
WebView2 dropped the unicode symbols. - ComfyUI prompts are cancelled on timeout and transport failure, not only on user stop.
- Template import bounds ZIP entry count and declared expansion before reading any member.
- Run identity is (workspace, run directory); two workspaces can hold runs with the same
directory name. Run ids keep their case throughout. - Missing left/right facings are no longer described as mirrored at export.
- Tagged builds stamp the version into the Python package and the desktop shell together, and
the release workflow verifies the packaged sidecar reports it. - Creating a character no longer ranks key colours on every upload; four sources upload in
parallel and the dialog closes in well under a second instead of 20–30 s. - A wide source that does not fit the canvas at the template's figure height is staged at the
largest ratio that fits and reported as a warning that offers the fitting ratio with one click, instead of
failing the key check and the run. - The generate gate's dry run no longer shows up as a completed run or counts as one; a
show dry runs toggle lists them for deletion. - The job dock keeps the running job pinned at the top and never evicts it behind a long
queue; queued and finished jobs collapse to one line each, and a run in progress is visible
after navigating to the character in-app, not only after a full reload. - Export build is disabled while a freeze runs, so it cannot hand out the previous build
during the eight seconds the new one takes. - The new-workspace wizard uses the real template editor, staged: actions, motions and geometry
are set before anything reaches disk, and Cancel leaves nothing behind. - Two concurrent first scans of a fresh workspace no longer race on the catalog's unique index
(a 500 on the workspace check). - The stray
runs/folder under the app-data directory is no longer created; runs live under
their workspace.
Breaking changes
- The catalog is rebuilt on first launch. There is no migration in the alpha. Job history
and custom motions in the motion store are lost; built-in motions are reseeded. Motions
that live in template or character files (motions/<action>.txt) are files and stay. - Action ids are written into project and template TOML on save. A file without ids still
loads; the id is derived from the name once and written back on the next save. Motion files
of actions are named by id from now on. - New directories under each character:
build/slots/,build/aliases.jsonand
build/<NNNN>/for frozen builds. Views live inviews/under the workspace. Archiving a
character now writes an emptyarchivedmarker file beside itsproject.toml, so the state
survives the catalog rebuild; archived characters are read-only and stay on the roster. - Run manifests record the project id and the action id of every cell. Existing runs are
matched by character name and action name. A run whose character name is shared by two
characters stays detached and shows under neither (see Known gaps). - Sheet format 3.
sheet.jsonrecords the run, cell, processing revision and frame index of
every packed frame. Packs made by v0.0.1 are left as they are; every new pack and every build
writes format 3. - The Generation, Review and Export pages are gone. Their addresses redirect to the roster
or the last opened character. Generation lives in the drawer and the Settings tab; review
opens from a run's cell; export is the Builds tab, the Runs tab and the roster menu. The
composed-versus-verbatim prompt diff has no UI; the drawer shows the verbatim override as text.
Known gaps
- Mirroring a facing from its opposite is not available; generate all four facings or waive.
- No detach from template for an inherited action; override fields instead.
- No UI for archive, import, rescan or deleting a workspace.
- A template can be copied from another workspace only in the new-workspace wizard; for an
existing workspace copy the template folder on disk, the list rescans. - No way to attach a detached run (one recorded before ids whose character name is not unique
in the workspace) to a character. Give the characters distinct names before upgrading, or
regenerate. - Exports run to completion; a large contact sheet or strips zip cannot be cancelled.
- The local API has no credential; anything on the same machine can talk to it on loopback.
- Windows only; the installer is unsigned and SmartScreen warns on first run. Verify the
download with the checksum and the attestation as the README describes. - Browser end-to-end tests do not run in CI; the desktop pass before this release was manual.
Upgrade note
- Quit Sprite H3 and back up
%AppData%\app.sprite-h3.desktop\(config, workflows,
workspaces, catalog). - Note down custom motions from the motion store; they are not carried over.
- Install v0.1.0 over the old version and launch. The catalog rebuilds from the files:
templates, characters and runs index as before, runs attach to characters by name and to
actions by name. - Open each character once. Cells in the Unassigned row of the matrix are runs whose action
name matches nothing current; Assign to… attaches them to an action. - Slots start empty. Fill them from the existing runs and freeze the first build.
Full Changelog: v0.0.1...v0.1.0