Skip to content

Play a finished motion-graphics ad in sync with the rough drafts it grew from, and export the breakdown as MP4.

release 1.0.1: faster hero, clearer first screen, first-run polish

Kaihan Waselyd3d7039f6e79
diff --git a/README.md b/README.md
index 55d55c1..08618f3 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,8 @@
<h1 align="center">Null Motion</h1>
<p align="center">
- <b>Watch a finished motion-graphics ad play over the rough drafts it grew from, frame-synced.<br>Then export the whole breakdown as one MP4.</b>
+ <b>See how a finished motion-graphics ad was built — draft by draft, frame by frame.<br>
+ Final film on top. Rough HyperFrames drafts underneath. Export the breakdown as one MP4.</b>
</p>
<p align="center">
@@ -21,7 +22,11 @@
</p>
<p align="center">
- <img src="docs/demo-infinite.gif" width="820" alt="The Infinite ad playing on top, its black-and-white drafts underneath, in sync">
+ <sub>If this helps you study or pitch motion work, a <a href="https://github.com/blixvip/NullMotion">⭐</a> makes it easier for others to find.</sub>
+</p>
+
+<p align="center">
+ <img src="docs/demo-infinite.webp" width="820" alt="The Infinite ad playing on top, its black-and-white drafts underneath, in sync">
</p>
<p align="center">
@@ -31,11 +36,11 @@
## Quick start
```sh
-git clone https://github.com/blixvip/NullMotion.git && cd NullMotion # 1. get it
-npm start # 2. run it (Node 22+, nothing to install)
+git clone https://github.com/blixvip/NullMotion.git && cd NullMotion
+npm start # Node 22+, nothing to install
```
-3. Open **<http://127.0.0.1:4343>**, pick a reference, and press **Download → Whole preview** (Chrome or Edge) to get the MP4.
+Then open **<http://127.0.0.1:4343>**, pick a reference, and press **Download → Whole preview** (Chrome or Edge) to get the MP4.
No `npm install`, no API keys, no account. Three references ship with the repo, so it works on the first run.
@@ -78,7 +83,7 @@ The repo ships three references with their drafts, ready to play:
| <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">
+ <img src="docs/demo-motion-study-08.webp" width="620" alt="Motion study 08 above its drafts">
</p>
These clips come from other creators and are used as examples. They are not claims of commissioned work.
@@ -176,7 +181,7 @@ Bug reports, draft ideas, and pull requests are welcome. See [CONTRIBUTING.md](C
## Community
<p align="center">
- <a href="https://discord.gg/zEB4VjmfSb"><img src="https://img.shields.io/badge/Discord-Join%20Insider%20AI-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join the Insider AI Discord"></a>
+ <a href="https://discord.gg/zEB4VjmfSb"><img src="https://img.shields.io/badge/Join%20the%20Discord-questions%2C%20help%2C%20show%20your%20renders-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join the Discord: questions, help, show your renders"></a>
</p>
-💬 Questions, help, feedback, release news, and your renders all go in **[Insider AI on Discord](https://discord.gg/zEB4VjmfSb)**. If Null Motion helped you, a ⭐ helps other people find it.
+💬 Questions, help, feedback, release news, and your renders all go in the **[Discord](https://discord.gg/zEB4VjmfSb)**. If Null Motion helped you, a ⭐ helps other people find it.
diff --git a/docs/demo-infinite.gif b/docs/demo-infinite.gif
deleted file mode 100644
index 869790b..0000000
Binary files a/docs/demo-infinite.gif and /dev/null differ
diff --git a/docs/demo-infinite.webp b/docs/demo-infinite.webp
new file mode 100644
index 0000000..fca6375
Binary files /dev/null and b/docs/demo-infinite.webp differ
diff --git a/docs/demo-motion-study-08.gif b/docs/demo-motion-study-08.gif
deleted file mode 100644
index 52096ba..0000000
Binary files a/docs/demo-motion-study-08.gif and /dev/null differ
diff --git a/docs/demo-motion-study-08.webp b/docs/demo-motion-study-08.webp
new file mode 100644
index 0000000..30c6d67
Binary files /dev/null and b/docs/demo-motion-study-08.webp differ
diff --git a/package.json b/package.json
index 1fa7ddd..307855b 100644
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
{
"name": "null",
- "version": "1.0.0",
+ "version": "1.0.1",
"private": true,
- "description": "Launch-film preview: a finished motion-graphics ad over its black-and-white HyperFrames drafts, with frame-accurate MP4 export.",
+ "description": "Finished motion-graphics ads over their HyperFrames drafts, frame-synced. Export the breakdown as an MP4. Local, zero dependencies.",
"type": "module",
"scripts": {
"start": "node server.js",
@@ -12,5 +12,7 @@
"waveforms": "node scripts/build-waveforms.mjs",
"showcase": "node scripts/build-showcase.mjs"
},
- "engines": { "node": ">=22" }
+ "engines": {
+ "node": ">=22"
+ }
}
diff --git a/public/demo.css b/public/demo.css
index a7d5fe8..9056052 100644
--- a/public/demo.css
+++ b/public/demo.css
@@ -20,7 +20,8 @@ button { font: inherit; color: inherit; background: none; border: 0; padding: 0;
.logo { color: var(--text); text-decoration: none; font-size: 16px; font-weight: 600; letter-spacing: -.02em; }
.logo span { color: var(--accent); }
.bar-meta { color: var(--muted); font-size: 12px; }
-.bar-link { margin-left: auto; color: var(--muted); font-size: 12px; text-decoration: none; }
+.bar-links { margin-left: auto; display: flex; align-items: center; gap: 14px; }
+.bar-link { color: var(--muted); font-size: 12px; text-decoration: none; }
.bar-link:hover { color: var(--text); }
.stage { width: var(--w); margin: 4px auto 32px; display: flex; flex-direction: column; }
@@ -54,8 +55,9 @@ button { font: inherit; color: inherit; background: none; border: 0; padding: 0;
.playhead span { position: absolute; top: 0; left: -5px; width: 10px; height: 10px; border-radius: 50%; background: #fff; box-shadow: 0 0 0 1px rgba(0, 0, 0, .35); }
.seek { position: absolute; width: 1px; height: 1px; opacity: 0; pointer-events: none; }
.stage:has(.seek:focus-visible) .strip { outline: 2px solid var(--accent); outline-offset: 6px; border-radius: 8px; }
-.times { display: flex; justify-content: space-between; margin-top: 10px; font: 500 11px Inter, system-ui, sans-serif; color: var(--muted); font-variant-numeric: tabular-nums; }
+.times { display: flex; justify-content: space-between; align-items: baseline; gap: 12px; margin-top: 10px; font: 500 11px Inter, system-ui, sans-serif; color: var(--muted); font-variant-numeric: tabular-nums; }
.times strong { color: var(--text); font-weight: 500; }
+.times #hint { flex: 1; text-align: center; color: var(--faint); font-weight: 400; }
/* Download */
.download { position: relative; }
diff --git a/public/demo.html b/public/demo.html
index 47d514c..4760ed9 100644
--- a/public/demo.html
+++ b/public/demo.html
@@ -2,7 +2,7 @@
<html lang="en">
<head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
- <meta name="theme-color" content="#0b0b0c"><title>Null — Launch Studio</title>
+ <meta name="theme-color" content="#0b0b0c"><title>Null Motion</title>
<link rel="icon" href="assets/null-logo.png"><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap"><link rel="stylesheet" href="demo.css">
<script src="_vendor/gsap.min.js"></script>
<script src="_vendor/mp4-muxer.js"></script>
@@ -12,11 +12,14 @@
<header class="bar">
<a class="logo" href="/">null<span>.</span></a>
<span class="bar-meta" id="bar-meta"></span>
- <a class="bar-link" href="/editor">Open editor</a>
+ <nav class="bar-links" aria-label="Links">
+ <a class="bar-link" href="https://discord.gg/zEB4VjmfSb" target="_blank" rel="noopener">Discord</a>
+ <a class="bar-link" href="/editor">Open editor</a>
+ </nav>
<div class="download">
<button class="download-button" id="download" aria-haspopup="menu" aria-expanded="false"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 4v11m-5-5 5 5 5-5M5 20h14"/></svg><span id="download-label">Download</span></button>
<div class="download-menu" id="download-menu" role="menu" hidden>
- <button role="menuitem" id="download-all"><strong>Whole preview</strong><span>Final film and its drafts in one MP4</span></button>
+ <button role="menuitem" id="download-all"><strong>Whole preview</strong><span>Final film and its drafts in one MP4 · Chrome / Edge</span></button>
<button role="menuitem" id="download-final"><strong>Final film only</strong><span>The original reference video</span></button>
</div>
</div>
@@ -31,11 +34,11 @@
<div class="scraps" id="scraps"></div>
<div class="playhead" id="playhead"><span></span></div>
</section>
- <div class="times"><strong id="time-now">0:00.0</strong><span id="time-total">0:00</span></div>
+ <div class="times"><strong id="time-now">0:00.0</strong><span id="hint">Drag drafts to scrub · Space to pause</span><span id="time-total">0:00</span></div>
<input class="seek" id="seek" type="range" min="0" max="1" step="0.01" value="0" aria-label="Seek">
</main>
<section class="library" aria-labelledby="library-title">
- <div class="library-head"><h2 id="library-title">All videos</h2><span id="library-count"></span></div>
+ <div class="library-head"><h2 id="library-title">Pick a reference</h2><span id="library-count"></span></div>
<div class="library-grid" id="library"></div>
</section>
</body>
diff --git a/public/demo.mjs b/public/demo.mjs
index fedee12..7868822 100644
--- a/public/demo.mjs
+++ b/public/demo.mjs
@@ -159,7 +159,16 @@ $('sound').addEventListener('click', () => {
$('sound').setAttribute('aria-label', video.muted ? 'Unmute' : 'Mute');
});
document.addEventListener('keydown', event => {
- if (event.code === 'Space' && !event.target.closest('button, input')) { event.preventDefault(); $('final-toggle').click(); }
+ if (event.target.closest('button, input, a')) return;
+ if (event.code === 'Space') { event.preventDefault(); $('final-toggle').click(); return; }
+ if (exporting || !sections.length) return;
+ if (event.code === 'ArrowLeft' || event.code === 'ArrowRight') {
+ event.preventDefault();
+ const active = sectionAt(video.currentTime || 0);
+ const next = event.code === 'ArrowRight' ? Math.min(sections.length - 1, active + 1) : Math.max(0, active - 1);
+ video.currentTime = sections[next].start;
+ render();
+ }
});
new ResizeObserver(layout).observe($('stage'));
@@ -338,7 +347,7 @@ async function start() {
references = catalog?.references || []; drafts = spec || drafts; bounds = planned || {}; cuts = changes || {};
if (!references.length) {
const notice = document.createElement('div'); notice.className = 'notice';
- notice.textContent = 'Import the MotionClone references to play this preview.';
+ notice.textContent = 'No references found. The showcase should ship with this repo — if you are building from a sparse checkout, run npm run showcase, or import your own with scripts/import-motionclone.py.';
document.querySelector('.final').append(notice);
return;
}
diff --git a/test/server.test.js b/test/server.test.js
index c8b5e30..9c48fb5 100644
--- a/test/server.test.js
+++ b/test/server.test.js
@@ -12,7 +12,7 @@ test('public workspace is standalone, read-only, and serves its own previews', a
const home = await get('/');
assert.equal(home.status, 200);
- assert.match(await home.text(), /Null.*Launch Studio/);
+ assert.match(await home.text(), /Null Motion/);
assert.match(await (await get('/editor')).text(), /id="clips-track"/);
assert.match(await (await get('/index.html')).text(), /Template Gallery/);
const catalog = await (await get('/api/v1/templates')).json();