Frameshell 0.4.0

Highlights

• Live preview of generated clips: while a HyperFrames or Remotion clip is still rendering, the preview plays its composition live in place of the "rendering" slate, seeked to the playhead (frame-exact while paused). Edit the composition or its props and the preview reloads at once; the finished render takes over when it is ready. See ADR 0010.
• frameshell in any terminal: File → Install 'frameshell' Command in PATH (macOS /usr/local/bin, Windows user PATH). On Linux the .deb now installs /usr/bin/frameshell itself; before, it started the app instead of running the CLI. frameshell doctor says which frameshell your PATH runs.
• Faster HyperFrames renders: compositions from frameshell hyperframes new no longer wait 45 s for a timeline they do not have. For compositions you made before, add data-no-timeline to the root element.
• Also: --ripple-track for clip add and clip trim, aborted transactions marked in the History panel, and frameshell --version in the app printing the app's version.

Upgrading: @frameshell/hyperframes and @frameshell/remotion are now 0.2.0. To update a project, run frameshell plugin install @frameshell/hyperframes@0.2.0 (or @frameshell/remotion@0.2.0) in it. The plugin version is part of the render cache key, so existing clips render once more after the update.

Platform notes

• macOS: signed and notarized (Apple silicon and Intel).
• Linux: beta, not yet verified by hand. CI builds the .deb and AppImage, runs the end-to-end suite on Ubuntu x64, and installs the .deb to check its frameshell command. On Linux arm64, HyperFrames and Remotion clips cannot render (no headless Chrome build).
• Windows: the installer is unsigned. SmartScreen warns on first run ("More info" → "Run anyway").

Official plugins: @frameshell/whisper-cpp 0.1.0, @frameshell/hyperframes 0.2.0 and @frameshell/remotion 0.2.0 on npm. Full list of changes: CHANGELOG.md.

What's Changed

• docs(readme): install section for the v0.3.0 release by @ThomasPraun in #140
• feat(desktop): install the frameshell CLI on the system PATH by @ThomasPraun in #141
• feat(desktop): mark aborted transactions in the History panel by @ThomasPraun in #144
• feat(cli): --ripple-track for clip add and clip trim by @ThomasPraun in #146
• fix(hyperframes): scaffold marks its root data-no-timeline, sparing a 45 s wait by @ThomasPraun in #154
• feat(cli): doctor names the frameshell on PATH and whether it is this CLI (#142) by @ThomasPraun in #153
• docs(adr): 0010 live preview by @ThomasPraun in #147
• feat(core): livePreview adapter contract and clip.live (ADR 0010, slice 1) by @ThomasPraun in #148
• feat(hyperframes): live preview page (ADR 0010, slice 2) by @ThomasPraun in #149
• feat(desktop): live preview of generated clips (ADR 0010, slice 3) by @ThomasPraun in #150
• feat(remotion): live preview page (ADR 0010, slice 4) by @ThomasPraun in #151
• docs: live preview in the SPEC, ADR notes, adapter skills and READMEs (ADR 0010) by @ThomasPraun in #152
• chore(release): 0.4.0 by @ThomasPraun in #155
• fix(desktop): .deb installs a frameshell command that runs the CLI (#143) by @ThomasPraun in #156
• docs(changelog): the .deb frameshell fix ships in 0.4.0 by @ThomasPraun in #157

Full Changelog: v0.3.0...v0.4.0