Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions .github/workflows/studiox-video.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: StudioX motion film

on:
pull_request:
paths:
- "projects/studiox/**"
- ".github/workflows/studiox-video.yml"
workflow_dispatch:

permissions:
contents: read

env:
HYPERFRAMES_NO_TELEMETRY: "1"
HYPERFRAMES_SKIP_SKILLS: "1"

jobs:
validate:
runs-on: ubuntu-24.04
timeout-minutes: 15
defaults:
run:
working-directory: projects/studiox
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
with:
node-version: "22"
cache: npm
cache-dependency-path: projects/studiox/package-lock.json
- run: npm ci
- run: npm run assets
- run: npm audit --omit=dev --audit-level=high
- run: npx --no-install hyperframes browser ensure
- run: npm run check
- name: Render the review film
if: github.event_name == 'workflow_dispatch'
run: npm run render
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
if: github.event_name == 'workflow_dispatch'
with:
name: StudioX-1080p
path: projects/studiox/renders/StudioX-1080p.mp4
if-no-files-found: error
8 changes: 8 additions & 0 deletions projects/studiox/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
node_modules/
renders/
snapshots/
.hyperframes/
.thumbnails/
assets/soundtrack.wav
*.log
assets/gsap.min.js
16 changes: 16 additions & 0 deletions projects/studiox/BRIEF.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
workflow: general-video
flow: automation
storyboard: no
message: "Great ideas should move faster."
aspect: 1920x1080
language: en
length: 30s
narration: no
---

Create the first StudioX promotional motion film. StudioX is one word. Use dramatic typography, bold motion and an original sound bed. The film is a promotional concept, not a claim that a new software platform has shipped. Keep Hyperframes out of the on-screen creative; retain engine attribution in source documentation.

The user authorized a first multi-model test and GitHub work. Astra supplies creative direction, Sol builds, and Luna reviews the rendering contract. This first sample establishes a working source/render loop, not superiority over other models or a measured 90–99% speedup.

Assumed first review format: landscape 1080p at 30 fps. 4K uses the same composition after the motion is reviewed. All fonts, scripts and sound are local. No API billing or production deployment.
33 changes: 33 additions & 0 deletions projects/studiox/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# StudioX · First motion film

30-second promotional concept: **Great ideas should move faster.**

This project uses the existing Hyperframes engine. It is the first motion sample, not a shipped StudioX editor or proof of model superiority.

## Run

Node 22+, FFmpeg/FFprobe and Chromium are required. From this directory:

```bash
npm ci
npm run assets
npm run check
npm run preview
npm run render
```

The CLI and GSAP are pinned by package-lock.json. `assets` regenerates the original 30-second stereo soundtrack and local GSAP bundle; English glyph subsets of the DejaVu fonts are shipped (basic Latin plus punctuation). No audio provider, key or paid API is used. After install and browser setup, rendering uses local assets.

`npm run render:4k` supersamples the same 1920×1080 layout to 3840×2160. It takes longer; review the 1080p film first. `HYPERFRAMES_BROWSER_PATH` can point at an existing Chromium executable. To fix a missing managed browser, use `npx --no-install hyperframes browser ensure`.

## Editing contract

`storyboard.json` holds copy, scene slots, motion cues and palette. After changes run `node scripts/sync-storyboard.mjs`, then `npm run check`. The verifier rejects mismatched scene timing, duplicate IDs, bad cues, copy references and audio duration. The JSON is a StudioX authoring manifest; Hyperframes reads the generated HTML and paused GSAP timeline.

`style.css` holds resting layouts; `motion.js` holds the tested choreography. Changing text needs fit review. Changing scene lengths also needs audio re-timing in `scripts/prepare-assets.mjs`. This first film deliberately keeps a single timeline; adding more subjects should extract proven motifs into scene components before claiming reusable automation.

## Provenance and review

Astra: creative direction. Sol: implementation. Luna: rendering-contract review. Root agent: integration, sound, validation and GitHub delivery. Fonts: DejaVu (license in assets/FONT-LICENSE.txt). GSAP 3.14.2 retains its upstream license notice; see https://gsap.com/standard-license. Hyperframes: Apache-2.0 (repository LICENSE).

Measure authoring, correction, browser setup, frame capture, encode and audio mixing separately. This first run includes cold setup; there is no matched Opus or open-weight baseline and no substantiated 90–99% speed claim.
Binary file added projects/studiox/assets/Display.ttf
Binary file not shown.
78 changes: 78 additions & 0 deletions projects/studiox/assets/FONT-LICENSE.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: DejaVu fonts
Upstream-Author: Stepan Roh <src@users.sourceforge.net> (original author),
see /usr/share/doc/fonts-dejavu-core/AUTHORS for full list
Source: https://dejavu-fonts.github.io/

Files: *
Copyright: Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved.
Bitstream Vera is a trademark of Bitstream, Inc.
DejaVu changes are in public domain.
License: bitstream-vera
Permission is hereby granted, free of charge, to any person obtaining a copy
of the fonts accompanying this license ("Fonts") and associated
documentation files (the "Font Software"), to reproduce and distribute the
Font Software, including without limitation the rights to use, copy, merge,
publish, distribute, and/or sell copies of the Font Software, and to permit
persons to whom the Font Software is furnished to do so, subject to the
following conditions:
.
The above copyright and trademark notices and this permission notice shall
be included in all copies of one or more of the Font Software typefaces.
.
The Font Software may be modified, altered, or added to, and in particular
the designs of glyphs or characters in the Fonts may be modified and
additional glyphs or characters may be added to the Fonts, only if the fonts
are renamed to names not containing either the words "Bitstream" or the word
"Vera".
.
This License becomes null and void to the extent applicable to Fonts or Font
Software that has been modified and is distributed under the "Bitstream
Vera" names.
.
The Font Software may be sold as part of a larger software package but no
copy of one or more of the Font Software typefaces may be sold by itself.
.
THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
FONT SOFTWARE.
.
Except as contained in this notice, the names of Gnome, the Gnome
Foundation, and Bitstream Inc., shall not be used in advertising or
otherwise to promote the sale, use or other dealings in this Font Software
without prior written authorization from the Gnome Foundation or Bitstream
Inc., respectively. For further information, contact: fonts at gnome dot
org.

Files: debian/*
Copyright: (C) 2005-2006 Peter Cernak <pce@users.sourceforge.net>
(C) 2006-2011 Davide Viti <zinosat@tiscali.it>
(C) 2011-2013 Christian Perrier <bubulle@debian.org>
(C) 2013 Fabian Greffrath <fabian+debian@greffrath.com>
License: GPL-2+
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later
version.
.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
.
You should have received a copy of the GNU General Public
License along with this package; if not, write to the Free
Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301 USA
.
On Debian systems, the full text of the GNU General Public
License version 2 can be found in the file
/usr/share/common-licenses/GPL-2'.
93 changes: 93 additions & 0 deletions projects/studiox/assets/GSAP-NOTICE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# GSAP (GreenSock Animation Platform)

[![GSAP - Animate anything](https://gsap.com/GSAP-share-image.png)](https://gsap.com)

GSAP is a **framework-agnostic** JavaScript animation library that turns developers into animation superheroes. Build high-performance animations that work in **every** major browser. Animate CSS, SVG, canvas, React, Vue, WebGL, colors, strings, motion paths, generic objects... anything JavaScript can touch! GSAP's <a href="https://gsap.com/docs/v3/Plugins/ScrollTrigger/">ScrollTrigger</a> plugin delivers jaw-dropping scroll-based animations with minimal code. <a href="https://gsap.com/docs/v3/GSAP/gsap.matchMedia()">gsap.matchMedia()</a> makes building responsive, accessibility-friendly animations a breeze.

No other library delivers such advanced sequencing, reliability, and tight control while solving real-world problems on over 12 million sites. GSAP works around countless browser inconsistencies; your animations ***just work***. At its core, GSAP is a high-speed property manipulator, updating values over time with extreme accuracy. It's up to 20x faster than jQuery!

GSAP is completely flexible; sprinkle it wherever you want. **Zero dependencies.**

There are many optional <a href="https://gsap.com/docs/v3/Plugins">plugins</a> and <a href="https://gsap.com/docs/v3/Eases">easing</a> functions for achieving advanced effects easily like <a href="https://gsap.com/docs/v3/Plugins/ScrollTrigger/">scrolling</a>, <a href="https://gsap.com/docs/v3/Plugins/MorphSVGPlugin">morphing</a>, [text splitting](https://gsap.com/docs/v3/Plugins/SplitText), animating along a <a href="https://gsap.com/docs/v3/Plugins/MotionPathPlugin">motion path</a> or <a href="https://gsap.com/docs/v3/Plugins/Flip/">FLIP</a> animations. There's even a handy <a href="https://gsap.com/docs/v3/Plugins/Observer/">Observer</a> for normalizing event detection across browsers/devices.


### Get Started

[![Get Started with GSAP](https://gsap.com/_img/github/get-started.jpg)](https://gsap.com/get-started)


## Docs &amp; Installation

View the <a href="https://gsap.com/docs">full documentation here</a>, including an <a href="https://gsap.com/install">installation guide</a>.

### CDN

```html
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14/dist/gsap.min.js"></script>
```

See <a href="https://www.jsdelivr.com/gsap">JSDelivr's dedicated GSAP page</a> for quick CDN links to the core files/plugins. There are more <a href="https://gsap.com/install">installation instructions</a> at gsap.com.

**Every major ad network excludes GSAP from file size calculations** and most have it on their own CDNs, so contact them for the appropriate URL(s).

### NPM
See the <a href="https://gsap.com/install">guide to using GSAP via NPM here</a>.

```javascript
npm install gsap
```

GSAP's core can animate almost anything including CSS and attributes, plus it includes all of the <a href="https://gsap.com/docs/v3/GSAP/UtilityMethods">utility methods</a> like <a href="https://gsap.com/docs/v3/GSAP/UtilityMethods/interpolate()">interpolate()</a>, <a href="https://gsap.com/docs/v3/GSAP/UtilityMethods/mapRange()">mapRange()</a>, most of the <a href="https://gsap.com/docs/v3/Eases">eases</a>, and it can do snapping and modifiers.

```javascript
// typical import
import gsap from "gsap";

// get other plugins:
import ScrollTrigger from "gsap/ScrollTrigger";
import Flip from "gsap/Flip";
import Draggable from "gsap/Draggable";

// or all tools are exported from the "all" file (excluding members-only plugins):
import { gsap, ScrollTrigger, Draggable, MotionPathPlugin } from "gsap/all";

// don't forget to register plugins
gsap.registerPlugin(ScrollTrigger, Draggable, Flip, MotionPathPlugin);
```

The NPM files are ES modules, but there's also a /dist/ directory with <a href="https://www.davidbcalhoun.com/2014/what-is-amd-commonjs-and-umd/">UMD</a> files for extra compatibility.

## GSAP is FREE!

Thanks to [Webflow](https://webflow.com), GSAP is now **100% FREE** including ALL of the bonus plugins like [SplitText](https://gsap.com/docs/v3/Plugins/SplitText), [MorphSVG](https://gsap.com/docs/v3/Plugins/MorphSVGPlugin), and all the others that were exclusively available to Club GSAP members. That's right - the entire GSAP toolset is FREE, even for commercial use! 🤯 Read more [here](https://webflow.com/blog/gsap-becomes-free)

### ScrollTrigger &amp; ScrollSmoother

If you're looking for scroll-driven animations, GSAP's <a href="https://gsap.com/docs/v3/Plugins/ScrollTrigger/">ScrollTrigger</a> plugin is the standard. There's a companion <a href="https://gsap.com/docs/v3/Plugins/ScrollSmoother/">ScrollSmoother</a> as well.

[![ScrollTrigger](https://gsap.com/_img/github/scrolltrigger.jpg)](https://gsap.com/docs/v3/Plugins/ScrollTrigger)

### Using React?

There's a <a href="https://www.npmjs.com/package/@gsap/react">@gsap/react</a> package that exposes a `useGSAP()` hook which is a drop-in replacement for `useEffect()`/`useLayoutEffect()`, automating cleanup tasks. Please read the <a href="https://gsap.com/react">React guide</a> for details.

### Resources

* <a href="https://gsap.com/">gsap.com</a>
* <a href="https://gsap.com/get-started/">Getting started guide</a>
* <a href="https://gsap.com/docs/">Docs</a>
* <a href="https://gsap.com/demos">Demos &amp; starter templates</a>
* <a href="https://gsap.com/community/">Community forums</a>
* <a href="https://gsap.com/docs/v3/Eases">Ease Visualizer</a>
* <a href="https://gsap.com/showcase">Showcase</a>
* <a href="https://www.youtube.com/@GreenSockLearning">YouTube Channel</a>
* <a href="https://gsap.com/cheatsheet">Cheat sheet</a>
* <a href="https://webflow.com">Webflow</a>

### Need help?
Ask in the friendly <a href="https://gsap.com/community/">GSAP forums</a>. Or share your knowledge and help someone else - it's a great way to sharpen your skills! Report any bugs there too (or <a href="https://github.com/greensock/GSAP/issues">file an issue here</a> if you prefer).

### License
GreenSock's standard "no charge" license can be viewed at <a href="https://gsap.com/standard-license">https://gsap.com/standard-license</a>.

Copyright (c) 2008-2025, GreenSock. All rights reserved.
Binary file added projects/studiox/assets/Mono.ttf
Binary file not shown.
13 changes: 13 additions & 0 deletions projects/studiox/hyperframes.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
{
"$schema": "https://hyperframes.heygen.com/schema/hyperframes.json",
"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
"paths": {
"blocks": "compositions",
"components": "compositions/components",
"assets": "assets"
},
"media": {
"autoProxy": true
},
"authoringSkill": "general-video"
}
Loading
Loading