Releases: zerodensity/ograf-studio
Release list
OGraf Studio 0.11
OGraf Studio 0.11
Released: 2026-09-03
OGraf Studio 0.11 expands editable motion backgrounds, compositing and AI authoring. The release
includes single-file servers for Windows x64, macOS Intel/Apple Silicon and Linux x64/ARM64.
Path paint and masks
- Paths support solid, linear, radial and conic fills, even-odd holes, color/gradient bindings and
independent gradient-stop animation. - Alpha and geometric path masks support inversion, source-only layers, animated sources, nested
dependencies and parent clipping. Duplication, components and collections remap mask references. - Browser PNG capture preserves native SVG masks and pattern references.
Procedural backgrounds and effects
- Shared pattern resources hold vector symbols, sequences, fitted rows, seeded spacing, direction,
cycle duration and row overrides. Linked fill, outline, glow and mask layers share motion. - The effects stack supports repeated blur, shadow, glow, brightness, contrast, saturation and hue
effects. Reorder, duplicate and bypass preserve stable parameter identities and animation. - Numeric effect parameters support lifecycle tracks, local loops, Brand Kit tokens and live OGraf
data. Scheduled seeking and updates preserve deterministic playback.
Brand Kit and interface
- Brand Kit is a dockable pane with direct palette swatches and Window-menu recovery.
- Gradient-stop, outline and shadow colors can follow Brand Kit tokens. Color fields can inherit
token defaults while accepting live playback overrides. - Remove applied pack detaches pack links while preserving current appearance and custom tokens.
- Interface typography is slightly smaller; authored graphic text keeps its original size.
AI authoring and packaging
- MCP operations, discovery, inspection and sampling expose patterns, masks and effect instances.
Updated external skills and in-app guidance include exact parameter paths and examples. - Source document version 28 retains compatibility with existing blur/shadow animation and bindings.
- Standalone servers explicitly embed the export runtime, fixing source-tree lookups in packaged
executables. Opening a project into an existing MCP session is undoable. - Product and MCP server versions are 0.11 / 0.11.0; Windows file metadata is 0.11.0.0.
- Updated
fast-urito 3.1.7 andqsto 6.16.0 to address the reported URI-normalization and
query-parser advisories. The release dependency audit reports no known vulnerabilities.
Downloads
| Platform | Single-file executable |
|---|---|
| Windows x64 | OGrafStudioServer.exe |
| macOS Intel | OGrafStudioServer-macos-x64 |
| macOS Apple Silicon | OGrafStudioServer-macos-arm64 |
| Linux x64 | OGrafStudioServer-linux-x64 |
| Linux ARM64 | OGrafStudioServer-linux-arm64 |
The destination machine needs no Node.js, npm, Bun or source checkout. Run the executable and open
http://127.0.0.1:4318/; use --help for port/workspace options. On macOS/Linux, first run
chmod +x <downloaded-file>. SHA-256 checksums, a build manifest and the matching authoring skill
archive accompany the release assets.
Verification and boundaries
- The repository verification gate covers 466 tests across 95 files, generated contracts/prompts,
formatting, lint, typechecks and production builds. - Windows and Linux x64 receive startup/HTTP smoke checks; Windows also exercises MCP and browser
rendering/export. All five artifacts receive binary-format, architecture/content and hash checks. - macOS and ARM64 binaries are cross-compiled and structurally checked; native execution on those
platforms remains unverified. Windows is unsigned; macOS builds are unsigned and not notarized. - Save/export uses automated OGraf conformance checks. These are not EBU certification or a claim
of compatibility with every third-party broadcast renderer. - A responsive editor remains necessary for capture and conformance checks. Components and Brand
Kit resources remain composition-local; portable cross-project component packaging and the
unified shared-lighting controller are still pending.
OGraf Studio 0.10
OGraf Studio 0.10
Released: 2026-09-02
OGraf Studio 0.10 adds self-contained Windows, macOS, and Linux distributions while preserving the
existing source development and independent MCP workflows. One executable per operating system and
architecture serves the complete browser editor, MCP endpoint, editor bridge, health/capture routes,
fonts, icons, schemas, and runtime dependencies.
Standalone server distribution
- Added
npm run server:package, which createsrelease/OGrafStudioServer.exewith the production
Vite editor and all server dependencies embedded. Bun is required only on the build machine; the
destination requires no Bun, Node.js, npm, installer, or source checkout. - Added
npm run server:package:allfor Windows x64, macOS Intel/Apple Silicon, and Linux x64/ARM64,
plus deterministic PE/Mach-O/ELF format, architecture, embedded-content, size, and SHA-256 checks. - Added
npm run server:startfor source-level testing of the combined host. - Added
--port,--workspace,--open,--no-open, and--helpcommand-line options while
retainingOGRAF_MCP_PORTandOGRAF_WORKSPACE_ROOTenvironment overrides. - Standalone storage defaults to
Documents/OGraf Studio/Projects, rather than the read-only
executable or source tree. - The packaged editor alone derives its
/editorWebSocket from the page origin. Normal Vite
development retainsws://127.0.0.1:4318/editorand normalnpm run mcp:startretains the
repository workspace default. - The first standalone release deliberately binds only to
127.0.0.1and retains the MCP SDK's
localhost host validation. Authenticated non-loopback hosting remains future work. - Packaging now stages and replaces the executable atomically so a failed build preserves the last
successful artifact.
Console and Windows branding
- Startup identifies OGraf Studio 0.10 and prints the public
https://github.com/zerodensity/ograf-studiosource URL. - Added a compact ASCII banner containing the Zero Density mark and a separately centered OGS
broadcast-arc/letter/peak icon. Every OGS row shares one centerline and the complete banner fits an
ordinary 80-column terminal. - Replaced Bun's default executable icon with a Windows icon derived from the existing OGraf Studio
project artwork. The packaged PE exposes the branded icon from 16 through 256 pixels. - Added Zero Density publisher, product, description, copyright, and
0.10.0.0Windows metadata.
Development workflow and defaults
- Added
npm run start:all, a Windows helper that launches the normal Vite editor and MCP server as
hidden background processes, skips already healthy services, waits for readiness, and writes
separate logs under.logs. - Locked the editor New path to the composition factory defaults: opaque black output with
Outside canvas · 20% gray enabled. Existing, imported, and autosaved projects retain their
authored background and layout settings.
Validation
-
npm run verifypasses generated MCP-contract and in-app-prompt drift checks, formatting, lint,
every workspace typecheck, 423 tests across 87 files, the runtime bundle, and the production
editor build. -
The standalone executable returned HTTP 200 for embedded editor HTML and its application bundle,
advertised all 26 MCP tools, rendered Timeline and Properties in a real browser without console
errors, and reported the same-origin editor bridge connected through/health. -
The independent
npm run mcp:startpath was also launched on a separate port and retained its
original workspace and endpoint behavior. -
The Linux x64 executable was also run under Ubuntu 22.04 on WSL: it served editor HTML and healthy
workspace JSON before shutting down cleanly. macOS and ARM64 binaries are cross-compiled and
structurally verified but still require native runner validation. -
Release artifacts:
Artifact Bytes SHA-256 OGrafStudioServer.exe118,703,104 24506e5d974b60ea0b13d5961c18b26b9d8d87ea59f229df76d695b25a84f327OGrafStudioServer-macos-x6470,076,992 ed6f3088d3f27fba6867fdbb1dc0a21a44d8cc8a70be284e77eb1c86eb2e43c7OGrafStudioServer-macos-arm6465,048,608 4ee99e87ba61508d660245b9807aa64bbfb8ecb841d51a8f51d0db8d93216c11OGrafStudioServer-linux-x64103,254,106 b32e31f8bfa7a1cef62a02a3283970cd62b414334617a555dbc594ea92979bb8OGrafStudioServer-linux-arm64102,695,154 bd53faf98da93f19477090b3189cbf4413f95ad8657f770a0cd72fea8f183afb -
The production editor continues to emit the documented large-chunk advisory. The Windows binary
is currently unsigned, and the macOS binaries are neither signed nor notarized. Facilities should
apply the appropriate platform signing process before broad external distribution.
OGraf Studio 0.09
OGraf Studio 0.09
Released: 2026-08-28
OGraf Studio 0.09 makes dense broadcast-authoring work faster and clearer. It expands Timeline and
layer-order editing, improves project/history reliability, adds a deliberate text-distortion mode,
and aligns the application chrome and configuration panes with the Zero Density/RealityHub visual
system. These editor changes do not alter authored canvas pixels unless the author explicitly uses
the new content properties.
Timeline editing
- Added Ctrl/Cmd additive selection across layer/property timeline rows and same-row Shift ranges.
Dragging or arrow-nudging any selected key moves the complete selection atomically, preserves
spacing, and stops at composition bounds or unselected keys on every affected track. - Set lifecycle, layer, and property key diamonds to 11 px. Loop badges and selection/focus
outlines scale with them without changing frame alignment or Timeline row heights. - Made the divider between Timeline layer/property names and keyframe tracks resizable. Dragging,
keyboard arrows, Home/End, and double-click reset are supported; the width persists locally and
always reserves usable track space. - Made Timeline Group names reliably editable by double-click, with full-name selection, F2 keyboard
access, and event handling that no longer lets the second click retrigger group selection. - Hidden selected-layer outlines and Moveable controls during Timeline playback. Selection is
preserved and its overlay returns immediately when playback pauses or stops. - Upgraded normal Timeline Play to sample every compiled local loop together, including scrolling
tickers and loops that continue while parked at a Step. Removed the redundant top Edit/OGraf
Preview switch and separate main-canvas runtime mode; Preview & Export remains available for
detailed playout actions and certification.
Layer ordering and reliability
- Added an editable Z order field to Properties. It maps directly to canonical layer paint
order, with1at the back and the current layer count at the front; values are rounded and
clamped to the available range. - Added standard Send to Back, Send Backward, Bring Forward, and Bring to Front toolbar actions.
They support multi-selection, retain internal order, and disable at the applicable boundary. - Added Ctrl/Cmd+A and Edit -> Select all layers for selecting the complete active composition
instead of webpage text. Hidden, locked, and guide layers are included; editable fields retain
native Select All behavior. - Browser Undo now reconciles the active composition and keyframe when restoring a snapshot from a
different bridge-synchronized project, preventing stale composition IDs from crashing the editor.
Docking and element authoring
- Changed Window-menu reopening so a closed pane first returns as a centered floating window rather
than docking automatically to its former/default edge. Multiple reopened panes cascade slightly
and remain fully dockable afterward. - Added Squeeze beside the existing text sizing modes. Resizing a squeezed text layer scales
glyph width and height independently to fill the box, enabling intentional condensed, expanded,
tall, or flattened text in the editor, capture path, and exported runtime. - Changed ordinary Rectangle, Ellipse, Text, Image, Path, Image Sequence, and Lottie creation to
alpha 1 at Start, Step, and End so new objects are immediately visible. Recipe motion retains its
explicit hidden entrance and exit states. - Replaced text-only add-element buttons with a consistent icon-only SVG set. Accessible names,
native titles, immediate custom tooltips, and clearer hover/focus feedback remain available.
Zero Density visual system
- Centralized the visual tokens sampled from the live RealityHub interface: Nunito, 14 px/13 px
hierarchy, charcoal surfaces,#dadada/#aaaaaatext,#399ed4active tabs,#60d0fffocus,
teal actions, 1 px separators, and flat 0/2 px geometry. - Bundled OFL-1.1 Nunito 400 Latin, Latin Extended, and Vietnamese subsets locally through
@fontsource/nunito; Studio does not depend on a running RealityHub server or external font CDN. - Applied the shared contract to application/header surfaces, docking tabs/groups/floating panes,
menus, panels, scrollbars, forms, selections, resources, layer rows, and element/timeline toolbars.
Authored graphic typography, canvas pixels, capture, certification, and export remain independent.
Configuration tables and numeric scrubbing
- Reworked Properties into RealityHub-style configuration tables with full-width section bars,
stable 42% label / 58% editor columns, 1 px row/column separators, aligned checkboxes, and
full-row Width/Height/effect/corner/frame-duration controls instead of scattered mini-grids. - Applied the same label/value column contract to Data test values and Preview data overrides while
preserving task-specific list, canvas, chat, resource-tree, and Timeline-track layouts. - Added one editor-wide RealityHub-style controller for every enabled numeric input: hover shows the
usage popup and east/west cursor, horizontal drag changes by the declared field step, Shift uses
10x speed, Alt uses 0.1x speed, and min/max bounds are respected. - Kept normal typing first-class: a sub-threshold click focuses and selects the value, while real
drags publish native bubbling input/change events through existing React/store/history actions.
Validation
npm run verifypasses generated MCP-contract and in-app-prompt drift checks, formatting, lint,
every workspace typecheck, 410 tests across 84 files, the runtime bundle, and the production
editor build.- Regression coverage includes multi-key selection, gutter resizing, z-order commands, Select All,
project-history reconciliation, Squeeze rendering, full-alpha creation defaults, the shared
configuration-grid contract, and numeric modifier/rounding/clamping behavior. - The production editor build continues to emit the documented large-chunk advisory. Headless
render/certify remains intentionally deferred, and real provider smoke testing still requires the
user's configured BYOK credentials.
OGraf Studio 0.08
OGraf Studio 0.08
Released: 2026-08-27
OGraf Studio 0.08 improves day-to-day editing feedback and presentation testing. It adds readable
Undo/Redo history, automatic AI references for selected layers, stronger chat progress and context
management, independent rectangle corner radii, editor-only video/still-image backgrounds, updated
project branding, and clearer Properties terminology. Authoring aids remain isolated from certified
OGraf playout output.
Undo, redo, and history
- Added a top Edit menu with Undo, Redo, shortcut labels, timestamps, and a scrollable 50-action
history display. - Added descriptive labels for common layer, property, animation, layout, resource, data, Brand Kit,
and lifecycle edits. - Added clickable multi-step history jumps across both undo and redo states while retaining the
existing debounced browser history as the sole source of truth. - Added
Ctrl+Yredo alongsideCtrl/Cmd+Shift+Z; existingCtrl/Cmd+Zundo remains unchanged.
AI chat feedback and references
- Added an always-visible active-turn strip with animation, provider/model phase, current tool,
model round, elapsed time, and progressively clearer long-wait guidance. - Added provider-round progress events, a configurable
OGRAF_AGENT_TIMEOUT_MSboundary (120
seconds by default), and explicit timeout/disconnect recovery that clears orphaned busy state. - Isolated chat history by project ID, capped individual tool results at 16,000 characters, bounded
complete history units to 96,000 characters, and added one safe retry when a provider rejects the
first round for context length. - Added automatic visible Chat reference chips for current canvas, Layers, and Timeline selection,
including multi-selection and primary property/key detail. Manual layer drops remain available for
removable references outside the current selection.
Canvas presentation and appearance
- New compositions now start with an opaque black canvas and an editor-only, fully opaque 20% gray
(#333333) outside-canvas surround. - Added a looping Big Buck Bunny HTML video behind Edit and OGraf Preview for evaluating transparent
graphics over moving footage. - Added a Still image presentation background using either an image URL or a locally selected
image embedded in.ogsup to 10 MiB. - Kept every presentation background behind the real composition and outside runtime descriptors,
capture, certification, and exported packages.
Independent corner radii
- Replaced the rectangle-wide radius with top-left, top-right, bottom-right, and bottom-left values,
plus an All corners convenience control. - Applied asymmetric radii consistently to editor/runtime DOM rendering, SVG diagnostics, gradients,
transformed child clipping, Brand Kit token targets, and MCP operations. - Migrated legacy numeric radii to four equal corners without changing existing visuals.
Interface and branding
- Renamed the user-facing Inspector pane to Properties across tabs, floating windows, close
actions, Window menu entries, accessibility labels, and guidance. - Replaced the default project/browser icon with the supplied OGraf Studio artwork and generated
dedicated 32 px favicon, 180 px Apple touch, and 512 px project icon assets.
Validation
npm run verifypasses generated-contract and prompt drift checks, formatting, lint, every
workspace typecheck, 380 tests across 79 files, the runtime bundle, and the production editor
build.- Browser smoke checks confirm the Properties controls, presentation-background modes, Edit history
menu, agent connection, and zero console errors. - Compiler tests confirm presentation image/video metadata remains absent from runtime descriptors.