Play a finished motion-graphics ad in sync with the rough drafts it grew from, and export the breakdown as MP4.
HTML after-effects-alternativeai-videoanimationbreakdowncreative-codingffmpeggood-first-issuegsaphelp-wantedhtml-videohyperframesjavascriptkinetic-typographymotion-designmotion-graphicsnodejsopen-sourcevideovideo-editingwebcodecs
README: logo, demo GIFs, screenshot and a clearer guide
waselyb1f2bfbed173
diff --git a/README.md b/README.mdindex 1a7facc..7da7677 100644--- a/README.md+++ b/README.md@@ -1,67 +1,108 @@-# Null+<p align="center">+ <img src="docs/logo.png" width="104" alt="Null logo">+</p>-A launch-film preview: a finished motion-graphics ad plays on top, and underneath it the super-simple black-and-white HyperFrames drafts it grew from — one per section, each an HTML scene driven by a GSAP timeline. A playhead runs across the drafts; the draft for the section on screen follows the film exactly and is outlined in orange. **Download → Whole preview** renders the film and its drafts frame by frame into a high-bitrate MP4 with the film's audio (Chrome or Edge).+<h1 align="center">Null Motion</h1>-The earlier launch editor (reference timeline, trimming, brand controls) is at `/editor`, and the original Null Motion gallery at `/index.html`.+<p align="center">+ <b>From rough drafts to a finished ad.</b><br>+ A finished motion-graphics ad plays on top. Underneath: the simple black-and-white<br>+ HyperFrames drafts it grew from, one per section, in sync with the film.+</p>-## Showcase+<p align="center">+ <img src="https://img.shields.io/badge/node-22%2B-111?style=flat-square" alt="Node 22+">+ <img src="https://img.shields.io/badge/dependencies-none-111?style=flat-square" alt="No runtime dependencies">+ <img src="https://img.shields.io/badge/drafts-HTML%20%2B%20GSAP-111?style=flat-square" alt="Drafts in HTML and GSAP">+ <img src="https://img.shields.io/badge/export-MP4%20%C2%B7%20WebCodecs-ff5a1f?style=flat-square" alt="MP4 export with WebCodecs">+</p>-The repository ships three references in `showcase/`: **Infinite · Global payments**, **SaaS · Launch sequence** and **Motion study 08**, with their drafts. They are reference clips from other creators, shown as examples; they are not claims of commissioned work. A fresh checkout plays these three. A locally imported library (below) takes precedence and is never committed.+<p align="center">+ <img src="docs/demo-infinite.gif" width="820" alt="Infinite ad playing above its drafts">+</p>-## Run locally+----Install Node.js 22 or newer, then:+## What it does-```sh-npm start-```+Every great ad starts as a rough draft. Null shows both at once:++- **The final film on top.** The full ad, full width, playing on a loop.+- **Its drafts underneath.** Each section (Hook, Reveal, App, End card…) has a plain HyperFrames scene: black and white, Arial type, flat shapes, one simple move. It shows the idea before the polish.+- **Everything in sync.** A playhead runs across the drafts. The draft for the section on screen follows the film frame for frame and gets an orange outline. The others keep looping their own part.+- **One-click export.** **Download → Whole preview** renders the film and its drafts frame by frame into a smooth, high-bitrate MP4 with the film's audio.-Open <http://127.0.0.1:4343>. There are no runtime packages to install and no credentials to configure.+<p align="center">+ <img src="docs/screenshot.jpg" width="820" alt="The Null Motion page: film, drafts, and the video library">+</p>-## Bring in MotionClone references+## Showcase-With Python, FFmpeg, and ffprobe installed:+The repo ships three references with their drafts, ready to play:-```sh-python scripts/import-motionclone.py --source /path/to/MotionClone-```+| | Reference | Length | Drafts |+|---|---|---|---|+| <img src="showcase/references/69614b10fa87-0.jpg" width="150"> | **Infinite · Global payments** | 0:30 | 7 |+| <img src="showcase/references/227b019e7968-0.jpg" width="150"> | **SaaS · Launch sequence** | 1:02 | 8 |+| <img src="showcase/references/5db95a3a7c73-0.jpg" width="150"> | **Motion study 08** | 0:03 | 3 |++<p align="center">+ <img src="docs/demo-motion-study-08.gif" width="620" alt="Motion study 08 above its drafts">+</p>-The importer includes saved source videos and the standalone Nexa/Troovy reference folders. It creates non-destructive segments of roughly four seconds, extracts a thumbnail for each segment, and links the videos into `.local-media/`. The source and this project must be on the same filesystem for hard links. Original files are read only; no encoding or source cutting occurs. Full source videos remain playable and segment in/out points are editable.+These clips come from other creators and are used as examples. They are not claims of commissioned work.-Media, reference titles, and extracted thumbnails stay local and are excluded from Git. The server supports byte ranges so seeking does not read entire videos into memory. A fresh checkout shows only the showcase until references are imported. Browser uploads last for the current session.+## Quick start-The curated local library contains 20 motion-graphics references and 142 segments. The live-action Astra promo is excluded by `data/reference-policy.json`; reimporting does not restore it. These are reference clips, not claims of commissioned work. Public hosting needs separately supplied media you can distribute.+```sh+git clone https://github.com/blixvip/NullMotion.git+cd NullMotion+npm start+```-`npm run showcase` rebuilds `showcase/` from the local library (re-encoded 1080p video, audio, posters, sections and drafts for the three showcase references). `scripts/plan-sections.mjs` splits references into sections at scene changes; the drafts themselves are authored in `public/references/drafts.json`.+Open **<http://127.0.0.1:4343>**. You need only Node.js 22 or newer: there's nothing to install and no keys to configure. Export needs Chrome or Edge (WebCodecs).-The preview displays source footage full-frame at its original proportions, with optional brand overlays, safe-area guides, and presentation mode. Brand layers do not rewrite text already in the footage. Saved custom sequences are retained; excluded references are removed from saved timelines when loaded.+## How it works-The optional `PORT` environment variable changes the port. `HOST` defaults to `127.0.0.1`; set it to your hosting environment's required bind address when deploying. This repository does not provision a hosted service.+1. **Sections.** `scripts/plan-sections.mjs` splits each reference into 3–8 sections at real scene changes (FFmpeg scene detection) and keeps every cut. Two-beat drafts switch at the exact moment the film cuts.+2. **Drafts.** `public/drafts.mjs` is a small HyperFrames engine: each draft is a 640×360 HTML scene on a paused GSAP timeline. A section is described by one or two *beats* (`text`, `logo`, `phone`, `window`, `input`, `chat`, `cards`, `list`, `chart`, `cloud`…), written to match the real frame's layout, text and timing.+3. **Playback.** The page drives every draft's timeline from the film's clock. The active section follows the film, and the others loop.+4. **Export.** A hidden copy of the film plays at half speed. `requestVideoFrameCallback` captures every decoded frame, the drafts are drawn at that frame's exact time, and WebCodecs encodes it at 24 Mbps with the frame's own timestamp. The audio is copied from the reference, and [mp4-muxer](https://github.com/Vanilagy/mp4-muxer) writes the MP4. Nothing is recorded in real time, so no frames are dropped.-## Develop+## Bring your own references++With Python, FFmpeg and ffprobe installed:```sh-npm run dev-npm run check-npm test+python scripts/import-motionclone.py --source /path/to/MotionClone+node scripts/plan-sections.mjs # sections + scene cuts + contact sheets```-- `public/editor.*` and `public/editor-model.mjs`: launch editor, interactions, and timeline operations.-- `public/`: the inherited gallery, styles, template previews, and artwork.-- `data/template-catalog.json`: the bundled template definitions.-- `server.js` and `media.js`: static UI data and streaming reference playback.-- `test/`: timeline boundaries, clip order, video ranges, previews, and file isolation.+Imported media stays local in `.local-media/` and `public/references/` (both ignored by Git) and takes precedence over the showcase. Describe each section's beats in `public/references/drafts.json`. Undescribed sections get placeholder drafts. `npm run showcase` rebuilds `showcase/` from the local library.-The browser calls this project's own origin. It does not connect to the original Null Motion companion. Build new authenticated backend routes before enabling generation or shared data storage.+The importer creates non-destructive segments, extracts thumbnails, and links the source videos. Original files are read only. The server streams byte ranges, so seeking never reads a whole video into memory. The optional `PORT` and `HOST` environment variables change the bind address.-## Project boundary+## Project layout-This project starts with fresh Git history. It contains no personal render history, database, provider configuration, local credentials, or Premiere extension. Drafts and UI preferences use this project's browser origin.--Only selected source media and its reference catalog are imported locally; MotionClone job records, generated outputs, and account settings are not copied. Brand changes apply to the concept composition. Text and marks baked into source footage remain unchanged.+```+public/demo.html · demo.mjs · demo.css the preview page and exporter+public/drafts.mjs HyperFrames draft engine (beat kinds)+public/scraps.mjs hand-built drafts for the Interface reference+public/editor.* the earlier launch editor, at /editor+showcase/ the three published references+scripts/ import, sections, showcase, waveforms, checks+server.js · media.js static server, media streaming, audio extraction+test/ server, media and editor tests+```-The original UI is retained to provide a starting point; inherited provider names, timing labels, and pipeline diagrams describe the future integration surface, not implemented service guarantees. External AI tools require their own accounts and may need to open in a separate tab.+```sh+npm run dev # restart on change+npm run check # UI file checks+npm test # node --test+```-## Third-party notices+## Notes-The bundled GSAP file retains its copyright and license header; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). Brand artwork belongs to its respective owners. No project-wide open-source license has been selected.+- The browser only calls this project's own origin. Generation, rendering services and Premiere are not connected. The drafts are authored, not AI-generated.+- The earlier launch editor (reference timeline, trimming, brand overlay) is at `/editor`, and the original Null Motion template gallery is at `/index.html`.+- Bundled GSAP and mp4-muxer keep their licenses; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). Brand artwork and reference footage belong to their respective owners. No project-wide open-source license has been selected.diff --git a/docs/demo-infinite.gif b/docs/demo-infinite.gifnew file mode 100644index 0000000..083ecd0Binary files /dev/null and b/docs/demo-infinite.gif differdiff --git a/docs/demo-motion-study-08.gif b/docs/demo-motion-study-08.gifnew file mode 100644index 0000000..52096baBinary files /dev/null and b/docs/demo-motion-study-08.gif differdiff --git a/docs/logo.png b/docs/logo.pngnew file mode 100644index 0000000..9d10424Binary files /dev/null and b/docs/logo.png differdiff --git a/docs/screenshot.jpg b/docs/screenshot.jpgnew file mode 100644index 0000000..6b8bc66Binary files /dev/null and b/docs/screenshot.jpg differ