Skip to content

Art and animation, written as code. Illustrations, loops, interactive web art, launch-videos and scored films in dozens of styles, identical on every render.

docs: music styles as vocabularies, the rebuilt sound, music.mjs check, launch kit v2 (README, five translations, plugin README, SKILL.md)

Alex Greenshpun31497bb5e5de
diff --git a/README.es-ES.md b/README.es-ES.md
index 5636c2d..f8da70f 100644
--- a/README.es-ES.md
+++ b/README.es-ES.md
@@ -94,7 +94,15 @@ Cada estilo entrega la imagen terminada y, de la misma fuente, una película de
## Música compuesta con código
-Sin muestras ni grabaciones. Las notas se escriben como datos y cada sonido se sintetiza: un piano modelado, con cuerdas que laten, martillos que iluminan el timbre y un pedal que prolonga la resonancia, además de marimba, arpa, guitarra, celesta, campanas, cuerdas, chiptune y batería. Todas las tonalidades mayores y menores, un estado de ánimo para cada sección y un tema que se ajusta a cualquier duración.
+Sin muestras ni grabaciones. Las notas se escriben como datos y cada sonido se sintetiza con código. Un estilo musical es un vocabulario con el que el modelo compone, nunca una plantilla: hay 21, del lo-fi electrónico, el house y el synthwave a la orquesta, el jazz, el folk y el piano solo. Cada uno aporta el sonido, los ritmos y el lenguaje armónico; los acordes, el motivo y la forma se escriben nuevos, así que cada película tiene su propia banda sonora.
+
+- **Teclados:** un piano modelado sobre un Steinway de cola real, pianos eléctricos Rhodes y Wurlitzer, órganos de ruedas fónicas y de tubos, láminas y campanas.
+- **Conjunto:** secciones de cuerda con músicos independientes, metales, flauta y clarinete, un coro que canta sus vocales, guitarras de nailon, acero y eléctricas, arpa y cuatro tipos de bajo.
+- **Batería:** kits reales hechos con código (acústico, 808, 909, polvoriento, escobillas, orquestal con timbales), cada golpe un poco distinto.
+- **Lo-fi de verdad:** un sampler de 12 bits, vaivén y soplido de cinta, crepitar de vinilo y un bombo que hace respirar la mezcla.
+- **Mezcla y sala:** ecualización por parte, bus de batería, reverbs de sala, placa y convolución, y un máster al volumen de las plataformas de streaming.
+
+`node tools/music.mjs check` aprueba una partitura antes de que nadie la escuche: tonalidad y modo, sonoridad, enmascaramiento, el equilibrio de cada parte y la novedad, que rechaza una partitura que suene como una conocida o la cite.
| Escucha | |
|---|---|
@@ -103,7 +111,7 @@ Sin muestras ni grabaciones. Las notas se escriben como datos y cada sonido se s
| [Cinemático, asombro](assets/audio/sampler-cinematic-awe-8s.mp3) · [Lo-fi](assets/audio/sampler-lofi-nostalgic-8s.mp3) · [Marimba](assets/audio/sampler-marimba-curious-8s.mp3) · [Electrónica](assets/audio/sampler-drive-electronic-8s.mp3) | más estados de ánimo e instrumentos |
| [El tema del nocturno en 15 segundos](assets/audio/fit-theme-15s.mp3) | El compositor elige la forma que cabe en ese tiempo |
-Y además: **lo-fi electrónico**, relajado y alegre, con pads cálidos y desafinados, una melodía suave punteada y un leve vaivén de cinta (la banda sonora del vídeo de lanzamiento se compuso en él; [el vocabulario](skills/anidoodle/references/music/styles/lofi-electronic.md)), y un **kit de efectos de sonido**: catorce efectos en capas y con semilla, sincronizados con el fotograma exacto, con la música bajando bajo cada uno ([diseño de sonido](skills/anidoodle/references/music/sound-design.md)). Un estilo es un vocabulario con el que componer, nunca notas ya hechas: cada película recibe una banda sonora escrita para ella.
+Y además: un **kit de efectos de sonido**, catorce efectos en capas y con semilla, sincronizados con el fotograma exacto, con la música bajando bajo cada uno ([diseño de sonido](skills/anidoodle/references/music/sound-design.md)). Cómo se compone una partitura: [`compose.md`](skills/anidoodle/references/music/compose.md) · [los 21 vocabularios](skills/anidoodle/references/music/styles/vocabularies.md).
## Páginas web que se fijan en ti
@@ -115,7 +123,14 @@ Ilustraciones interactivas para webs reales: una mascota que sigue el cursor y r
## Lanza tu producto, dibujado con código
-El vídeo al principio de esta página se hizo con anidoodle, y el kit con el que se hizo viene incluido. Dale el nombre de tu producto, las peticiones que escribiría un usuario, las imágenes que las responden, unas pocas palabras y tus líneas de instalación. Monta un vídeo de lanzamiento al ritmo de la música: un chat que se escribe solo, respuestas que se abren como tinta y se dibujan solas, rótulos a pantalla completa y una tarjeta final que mantiene tus líneas de instalación el tiempo suficiente para copiarlas.
+El vídeo al principio de esta página se hizo con anidoodle, y el kit con el que se hizo viene incluido. `launch.mjs new <nombre>` te da una especificación para rellenar: el nombre de tu producto, las peticiones que escribiría un usuario, las respuestas (una imagen dibujada, las pantallas de tu propio producto o una película), unas pocas palabras y tus líneas de instalación. Monta un vídeo de lanzamiento al ritmo de la música: un chat que se escribe solo, respuestas que se abren como tinta, rótulos a pantalla completa y una tarjeta final que mantiene tus líneas de instalación el tiempo suficiente para copiarlas.
+
+- **Cuatro formatos, una línea de tiempo:** 16:9, 1:1, 4:5 y 9:16, cada uno recompuesto para su encuadre con texto legible en un móvil.
+- **Tu producto en pantalla:** su interfaz dibujada a partir de datos, con elementos que saltan del estado anterior al nuevo.
+- **Sonido que sale de la imagen:** cada tecla, pulsación y aterrizaje tiene su efecto, situado donde ocurre en pantalla, sobre una banda sonora compuesta para el vídeo.
+- **Listo para publicar:** `launch.mjs ship <nombre>` renderiza cada formato con su fotograma de portada y sus subtítulos (.srt y .vtt), comprueba la sincronía de audio y vídeo y el nivel de pico en el archivo que entregas, y falla cualquier fotograma cuyo borde corte un texto.
+
+Dos estilos (tinta dibujada, o limpio para un producto centrado en su interfaz), a 30 o 60 fps, con desenfoque de movimiento ajustado a la velocidad de cada fotograma.
Las reglas salen de cuatro montajes de nuestro propio lanzamiento y del oficio de los mejores: di qué es en cinco segundos, nunca pongas texto sobre la ilustración, corta en el tiempo fuerte, haz que el primer fotograma sea la miniatura. → [`launch-video.md`](skills/anidoodle/references/workflows/launch-video.md) · [el kit](skills/anidoodle/references/workflows/launch-video-kit.md)
@@ -160,7 +175,7 @@ El motor es la mitad fácil. El oficio es la parte que anidoodle carga por ti: s
- **Historia** le da un sentido a cada pieza. Una idea y un motivo central para una imagen fija; una transformación, una recompensa y un elemento recurrente para una película. → [`storytelling.md`](skills/anidoodle/references/storytelling.md)
- **Realismo** viene de nombrarlo todo. La anatomía, el punto de vista y la referencia que abriste, para que una mariposa se lea como una criatura con cuerpo y venas. → [`realism-and-craft.md`](skills/anidoodle/references/realism-and-craft.md)
- **Estilo** vive en el trazo. Treinta y una recetas completas, una guía para elegir una según el encargo, y los pasos para inventar la tuya propia. → [`styles.md`](skills/anidoodle/references/styles.md)
-- **Música** se compone en notas y se sintetiza con código: un piano modelado y una docena de instrumentos, todas las tonalidades mayores y menores, un ánimo para cada sección y un tema que se adapta a cualquier duración. → [`music/README.md`](skills/anidoodle/references/music/README.md)
+- **Música** se compone para cada pieza a partir del vocabulario de un estilo y se sintetiza con código: 21 estilos, una banda y una orquesta completas, todas las tonalidades mayores y menores, un ánimo para cada sección y un tema que se adapta a cualquier duración. → [`music/README.md`](skills/anidoodle/references/music/README.md)
- **Determinismo** es la garantía. Funciones puras y un aleatorio con semilla, para que cualquiera con la fuente reconstruya exactamente la misma pieza. → [`determinism-and-contract.md`](skills/anidoodle/references/determinism-and-contract.md)
- **Método** te mantiene rápido. Demuestra el look en una sola imagen fija, construye de un tirón, y gasta las aprobaciones donde equivocarse sale caro. → [`working-method.md`](skills/anidoodle/references/working-method.md)
@@ -228,6 +243,8 @@ node tools/render.mjs intro --out out/intro.gif # a loop; also .mp4 w
node tools/emit.mjs intro --out out/intro.html # the whole piece as one offline file
node tools/gate.mjs hero # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4 # the file you ship, decoded and checked
+node tools/music.mjs check score.ts#myScore # your score: key, loudness, balance, novelty
+node tools/launch.mjs new myLaunch # a launch film spec; then: launch.mjs ship myLaunch
```
Node 20 o más reciente. Las imágenes fijas solo necesitan el navegador de arriba; todo lo que se mueve también usa `ffmpeg`.
diff --git a/README.fr-FR.md b/README.fr-FR.md
index 02c3b38..35a0d7a 100644
--- a/README.fr-FR.md
+++ b/README.fr-FR.md
@@ -94,7 +94,15 @@ Chaque style livre l'image achevée et, depuis la même source, un film de sa cr
## De la musique composée en code
-Ni échantillons ni enregistrements. Les notes sont écrites comme des données et chaque son est synthétisé : un piano modélisé, avec ses cordes qui battent, ses marteaux qui éclaircissent le timbre et sa pédale qui prolonge la résonance, mais aussi marimba, harpe, guitare, célesta, cloches, cordes, chiptune et batterie. Toutes les tonalités majeures et mineures, une humeur par section et un thème qui s'adapte à n'importe quelle durée.
+Ni échantillons ni enregistrements. Les notes sont écrites comme des données et chaque son est synthétisé en code. Un style musical est un vocabulaire à partir duquel le modèle compose, jamais un préréglage : il y en a 21, de la lo-fi électronique, la house et la synthwave à l'orchestre, au jazz, au folk et au piano seul. Chacun apporte le son, les grooves et le langage harmonique ; les accords, le motif et la forme sont écrits à neuf, donc chaque film a sa propre musique.
+
+- **Claviers :** un piano modélisé d'après un vrai grand Steinway, des pianos électriques Rhodes et Wurlitzer, des orgues à roues phoniques et à tuyaux, des claviers à lames et des cloches.
+- **Ensemble :** des pupitres de cordes aux musiciens indépendants, des cuivres, flûte et clarinette, un chœur qui chante ses voyelles, des guitares nylon, acier et électriques, une harpe et quatre sortes de basse.
+- **Batterie :** de vrais kits en code (acoustique, 808, 909, poussiéreux, balais, orchestral avec timbales), chaque frappe un peu différente.
+- **Une vraie lo-fi :** un échantillonneur 12 bits, le pleurage et le souffle de la bande, le craquement du vinyle et une grosse caisse qui fait respirer le mix.
+- **Mixage et acoustique :** égalisation par partie, bus de batterie, réverbes de salle, à plaque et à convolution, et un master au niveau des plateformes de streaming.
+
+`node tools/music.mjs check` valide une partition avant toute écoute : tonalité et mode, loudness, masquage, l'équilibre de chaque partie et la nouveauté, qui refuse une partition qui ressemble à une musique connue ou la cite.
| Écouter | |
|---|---|
@@ -103,7 +111,7 @@ Ni échantillons ni enregistrements. Les notes sont écrites comme des données
| [Cinématique, émerveillement](assets/audio/sampler-cinematic-awe-8s.mp3) · [Lo-fi](assets/audio/sampler-lofi-nostalgic-8s.mp3) · [Marimba](assets/audio/sampler-marimba-curious-8s.mp3) · [Électronique](assets/audio/sampler-drive-electronic-8s.mp3) | d'autres ambiances et instruments |
| [Le thème du nocturne en 15 secondes](assets/audio/fit-theme-15s.mp3) | Le compositeur choisit la forme adaptée à la durée |
-Et aussi : **la lo-fi électronique**, détendue et enjouée, avec des nappes chaudes et désaccordées, une mélodie pincée tout en douceur et un léger flottement de bande (la musique du film de lancement a été composée dans ce style ; [le vocabulaire](skills/anidoodle/references/music/styles/lofi-electronic.md)), et un **kit de bruitages** : quatorze effets superposés et déterministes, calés sur l'image exacte, la musique s'effaçant sous chacun d'eux ([le design sonore](skills/anidoodle/references/music/sound-design.md)). Un style est un vocabulaire avec lequel composer, jamais des notes toutes faites : chaque film reçoit une musique écrite pour lui.
+Et aussi : un **kit de bruitages**, quatorze effets superposés et déterministes, calés sur l'image exacte, la musique s'effaçant sous chacun d'eux ([le design sonore](skills/anidoodle/references/music/sound-design.md)). Comment on compose une partition : [`compose.md`](skills/anidoodle/references/music/compose.md) · [les 21 vocabulaires](skills/anidoodle/references/music/styles/vocabularies.md).
## Des pages web qui vous remarquent
@@ -115,7 +123,14 @@ Des illustrations interactives pour de vrais sites : une mascotte qui suit le cu
## Lancez votre produit, dessiné en code
-Le film en haut de cette page a été fait avec anidoodle, et le kit qui a servi à le faire est livré avec. Donnez-lui le nom de votre produit, les demandes qu'un utilisateur taperait, les images qui y répondent, quelques mots et vos lignes d'installation. Il monte un film de lancement en rythme : une conversation qui se tape toute seule, des réponses qui s'ouvrent comme une tache d'encre et se dessinent, du lettrage plein écran et un carton final qui garde vos lignes d'installation assez longtemps pour les copier.
+Le film en haut de cette page a été fait avec anidoodle, et le kit qui a servi à le faire est livré avec. `launch.mjs new <nom>` vous donne une fiche à remplir : le nom de votre produit, les demandes qu'un utilisateur taperait, les réponses (une image dessinée, les écrans de votre propre produit ou un film), quelques mots et vos lignes d'installation. Il monte un film de lancement en rythme : une conversation qui se tape toute seule, des réponses qui s'ouvrent comme une tache d'encre, du lettrage plein écran et un carton final qui garde vos lignes d'installation assez longtemps pour les copier.
+
+- **Quatre formats, une seule timeline :** 16:9, 1:1, 4:5 et 9:16, chacun recomposé pour son cadre avec un texte lisible sur téléphone.
+- **Votre produit à l'écran :** son interface dessinée à partir de données, les éléments passant d'un bond de l'état avant à l'état après.
+- **Le son vient de l'image :** chaque touche, chaque clic, chaque atterrissage a son effet, placé là où il se produit à l'écran, sur une musique composée pour le film.
+- **Prêt à publier :** `launch.mjs ship <nom>` rend chaque format avec son image d'affiche et ses sous-titres (.srt et .vtt), vérifie la synchronisation son-image et le niveau crête sur le fichier livré, et refuse toute image dont le bord coupe un texte.
+
+Deux looks (encre dessinée, ou épuré pour un produit centré sur son interface), en 30 ou 60 i/s, avec un flou de mouvement ajusté à la vitesse de chaque image.
Les règles viennent de quatre montages de notre propre lancement et du savoir-faire des meilleurs : dire ce que c'est en cinq secondes, ne jamais poser de texte sur l'illustration, couper sur le temps fort, faire de la première image la miniature. → [`launch-video.md`](skills/anidoodle/references/workflows/launch-video.md) · [le kit](skills/anidoodle/references/workflows/launch-video-kit.md)
@@ -160,7 +175,7 @@ Le moteur, c'est la partie facile. Le métier, c'est ce qu'anidoodle porte pour
- **Le récit** donne un sens à chaque pièce. Une idée et un sujet focal pour une image fixe ; une transformation, une résolution et un motif qui revient pour un film. → [`storytelling.md`](skills/anidoodle/references/storytelling.md)
- **Le réalisme** vient du fait de le nommer. L'anatomie, l'angle de vue et la référence que vous avez ouverte, pour qu'un papillon se lise comme une créature avec un corps et des nervures. → [`realism-and-craft.md`](skills/anidoodle/references/realism-and-craft.md)
- **Le style** habite la trace. Trente et une recettes complètes, un guide pour en choisir une par projet, et la marche à suivre pour inventer la vôtre. → [`styles.md`](skills/anidoodle/references/styles.md)
-- **La musique** se compose en notes et se synthétise par code : un piano modélisé et une douzaine d’instruments, toutes les tonalités majeures et mineures, une humeur par section et un thème adapté à toute durée. → [`music/README.md`](skills/anidoodle/references/music/README.md)
+- **La musique** se compose pour chaque pièce à partir du vocabulaire d'un style et se synthétise par code : 21 styles, un groupe et un orchestre complets, toutes les tonalités majeures et mineures, une humeur par section et un thème adapté à toute durée. → [`music/README.md`](skills/anidoodle/references/music/README.md)
- **Le déterminisme** est la garantie. Des fonctions pures et un aléatoire à graine fixe, pour que quiconque a le code source reconstruise exactement la même pièce. → [`determinism-and-contract.md`](skills/anidoodle/references/determinism-and-contract.md)
- **La méthode** vous fait gagner du temps. Prouvez le rendu sur une seule image fixe, construisez d'une traite, et réservez les validations aux endroits où se tromper coûte cher. → [`working-method.md`](skills/anidoodle/references/working-method.md)
@@ -228,6 +243,8 @@ node tools/render.mjs intro --out out/intro.gif # a loop; also .mp4 w
node tools/emit.mjs intro --out out/intro.html # the whole piece as one offline file
node tools/gate.mjs hero # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4 # the file you ship, decoded and checked
+node tools/music.mjs check score.ts#myScore # your score: key, loudness, balance, novelty
+node tools/launch.mjs new myLaunch # a launch film spec; then: launch.mjs ship myLaunch
```
Node 20 ou plus récent. Les images fixes n'ont besoin que du navigateur ci-dessus ; tout ce qui bouge utilise aussi `ffmpeg`.
diff --git a/README.ja-JP.md b/README.ja-JP.md
index aa35bfd..61489ec 100644
--- a/README.ja-JP.md
+++ b/README.ja-JP.md
@@ -94,7 +94,15 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
## コードで作曲する音楽
-サンプル音源も録音も使わない。音符をデータとして書き、すべての音を合成する。弦のうなり、打鍵の明るさ、響き続けるペダルまで再現したピアノのほか、マリンバ、ハープ、ギター、チェレスタ、ベル、弦楽器、チップチューン、ドラムを備える。長調と短調のすべての調、セクションごとのムード、そしてどんな長さにも収まるテーマ。
+サンプル音源も録音も使わない。音符をデータとして書き、すべての音をコードで合成する。音楽スタイルはモデルが作曲に使う語彙であって、プリセットではない。ローファイ・エレクトロニック、ハウス、シンセウェイヴからオーケストラ、ジャズ、フォーク、ピアノ独奏まで21種類。各スタイルが音色、グルーヴ、和声の語法を与え、コード、モチーフ、形式は毎回新しく書く。だから映像ごとに、その映像だけのスコアになる。
+
+- **鍵盤:** 実在のスタインウェイ・グランドをもとにモデル化したピアノ、ローズとウーリッツァーのエレクトリックピアノ、トーンホイール・オルガンとパイプオルガン、鍵盤打楽器とベル。
+- **アンサンブル:** 一人ひとりが独立して弾く弦楽セクション、金管、フルートとクラリネット、母音を歌い分ける合唱、ナイロン弦・スチール弦・エレクトリックのギター、ハープ、4種類のベース。
+- **ドラム:** コードで作った本物のキット(アコースティック、808、909、ダスティ、ブラシ、ティンパニ付きのオーケストラ)。一打ごとにわずかに違う。
+- **本物のローファイ:** 12ビットのサンプラー、テープの揺れとヒス、レコードのパチパチ音、ミックスを呼吸させるキック。
+- **ミックスと空間:** パートごとのEQ、ドラムバス、ホール・プレート・コンボリューションのリバーブ、ストリーミング基準の音量に仕上げるマスター。
+
+`node tools/music.mjs check` は、人が聴く前にスコアを審査する。調とモード、ラウドネス、マスキング、各パートのバランス、そして新規性。既存の曲に似ているスコアや引用したスコアは不合格になる。
| 試聴 | |
|---|---|
@@ -103,8 +111,7 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
| [シネマティック・畏敬](assets/audio/sampler-cinematic-awe-8s.mp3) · [ローファイ](assets/audio/sampler-lofi-nostalgic-8s.mp3) · [マリンバ](assets/audio/sampler-marimba-curious-8s.mp3) · [エレクトロニック](assets/audio/sampler-drive-electronic-8s.mp3) | ほかのムードと楽器 |
| [15秒に収めたノクターンのテーマ](assets/audio/fit-theme-15s.mp3) | 長さに合う構成を作曲家が選ぶ |
-さらに、**ローファイ・エレクトロニック**。温かくデチューンしたパッド、やわらかく爪弾くリード、かすかなテープの揺れで、落ち着いていて軽快(ローンチ映像の音楽はこのスタイルで作曲した。[語彙](skills/anidoodle/references/music/styles/lofi-electronic.md))。
-そして**効果音キット**。重ねて作るシード付きの効果音が十四種、フレーム単位で鳴り、そのたびに音楽が一歩引く([サウンドデザイン](skills/anidoodle/references/music/sound-design.md))。スタイルは作曲に使う語彙であって、できあいの音符ではない。どの映像にも、その映像のために書いたスコアがつく。
+そして**効果音キット**。重ねて作るシード付きの効果音が十四種、フレーム単位で鳴り、そのたびに音楽が一歩引く([サウンドデザイン](skills/anidoodle/references/music/sound-design.md))。スコアの作り方: [`compose.md`](skills/anidoodle/references/music/compose.md) · [21の語彙](skills/anidoodle/references/music/styles/vocabularies.md)。
## あなたに気づくウェブページ
@@ -116,7 +123,14 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
## 自分のプロダクトを、コードで描いてローンチする
-このページ冒頭の映像は anidoodle で作ったもので、そのときのキットも同梱している。プロダクト名、ユーザーが打ち込むプロンプト、それに応える絵、少しの言葉、インストール用の行を渡すと、拍に合わせてローンチ映像を編集する。ひとりでに入力されるチャット、インクのように開いて描き上がる回答、画面いっぱいのレタリング、そしてインストール行をコピーできるだけ長く見せるエンドカード。
+このページ冒頭の映像は anidoodle で作ったもので、そのときのキットも同梱している。`launch.mjs new <名前>` で記入用の仕様ができる。プロダクト名、ユーザーが打ち込むプロンプト、それに応える答え(描いた絵、自分のプロダクトの画面、または映像)、少しの言葉、インストール用の行。それを渡すと、拍に合わせてローンチ映像を編集する。ひとりでに入力されるチャット、インクのように開く回答、画面いっぱいのレタリング、そしてインストール行をコピーできるだけ長く見せるエンドカード。
+
+- **4つの画面比率、1本のタイムライン:** 16:9、1:1、4:5、9:16。それぞれの画角に合わせて組み直し、スマートフォンでも文字が読める。
+- **プロダクトを画面に:** データから描くインターフェース。要素が変更前の状態から変更後へ弾むように移る。
+- **絵から生まれる音:** キー入力、クリック、着地のひとつひとつに効果音がつき、画面上で起きた位置に定位する。その下に映像のために作曲したスコア。
+- **そのまま公開できる:** `launch.mjs ship <名前>` が各比率をレンダリングし、ポスターフレームと字幕(.srt と .vtt)を書き出し、納品ファイルで音と映像の同期とピークレベルを確かめ、文字が画面の端で切れるフレームを不合格にする。
+
+ルックは2種類(手描きのインク、またはUI中心のプロダクト向けのクリーン)。30 fps と 60 fps、各フレームの速さに合わせたモーションブラー。
ルールは、自分たちのローンチ映像を四度編集した経験と、優れたローンチ映像の技法から来ている。五秒以内に何なのかを伝える、絵の上に文字を置かない、強拍で切り替える、最初のフレームをサムネイルにする。 → [`launch-video.md`](skills/anidoodle/references/workflows/launch-video.md) · [キット](skills/anidoodle/references/workflows/launch-video-kit.md)
@@ -161,7 +175,7 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
- **物語**が、作品に意味を与える。一枚絵ならひとつのアイデアとひとつの主題。映画ならひとつの変化、ひとつの見せ場、そして繰り返し登場するモチーフがひとつ。→ [`storytelling.md`](skills/anidoodle/references/storytelling.md)
- **リアリズム**は、名づけることから生まれる。解剖学的な構造、視点、そして開いた参考資料。それがあってはじめて、蝶は体と翅脈を持つ生き物として見えてくる。→ [`realism-and-craft.md`](skills/anidoodle/references/realism-and-craft.md)
- **スタイル**は、線そのものに宿る。31の完全なレシピ、案件ごとに選ぶためのガイド、そして自分だけのスタイルを生み出す手順。→ [`styles.md`](skills/anidoodle/references/styles.md)
-- **音楽**は、音符を作曲し、コードで合成する。モデル化されたピアノと十数種類の楽器、すべての長調と短調、セクションごとの情感、どんな長さにも合うテーマを備えている。→ [`music/README.md`](skills/anidoodle/references/music/README.md)
+- **音楽**は、スタイルの語彙から作品ごとに作曲し、コードで合成する。21のスタイル、バンドとオーケストラ一式、すべての長調と短調、セクションごとの情感、どんな長さにも合うテーマを備えている。→ [`music/README.md`](skills/anidoodle/references/music/README.md)
- **決定性**が、その保証になる。純粋関数とシード付き乱数だから、ソースコードさえあれば誰でもまったく同じ作品を再構築できる。→ [`determinism-and-contract.md`](skills/anidoodle/references/determinism-and-contract.md)
- **手法**が、スピードを保ってくれる。まず一枚の絵で見た目を確かめ、そのまま一気に作り上げ、間違えるとコストの高いところにだけ承認をかける。→ [`working-method.md`](skills/anidoodle/references/working-method.md)
@@ -229,6 +243,8 @@ node tools/render.mjs intro --out out/intro.gif # a loop; also .mp4 w
node tools/emit.mjs intro --out out/intro.html # the whole piece as one offline file
node tools/gate.mjs hero # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4 # the file you ship, decoded and checked
+node tools/music.mjs check score.ts#myScore # your score: key, loudness, balance, novelty
+node tools/launch.mjs new myLaunch # a launch film spec; then: launch.mjs ship myLaunch
```
Node 20以降が必要。一枚絵なら上記のブラウザだけで足りるが、動くものにはすべて`ffmpeg`も使う。
diff --git a/README.ko-KR.md b/README.ko-KR.md
index 80e7f9d..abc1f42 100644
--- a/README.ko-KR.md
+++ b/README.ko-KR.md
@@ -94,7 +94,15 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
## 코드로 작곡한 음악
-샘플도 녹음도 쓰지 않아요. 음표는 데이터로 적고, 모든 소리를 합성해요. 현이 울리며 만드는 맥놀이, 세게 칠수록 밝아지는 해머, 오래 울리는 페달까지 구현한 피아노에 마림바, 하프, 기타, 첼레스타, 종, 현악기, 칩튠, 드럼이 있어요. 모든 장조와 단조, 구간마다 다른 분위기, 어떤 길이에도 맞춰지는 주제 선율까지요.
+샘플도 녹음도 쓰지 않아요. 음표는 데이터로 적고, 모든 소리를 코드로 합성해요. 음악 스타일은 모델이 작곡에 쓰는 어휘일 뿐, 프리셋이 아니에요. 로파이 일렉트로닉, 하우스, 신스웨이브부터 오케스트라, 재즈, 포크, 피아노 독주까지 21가지예요. 스타일은 음색과 그루브, 화성 어법을 주고, 코드와 모티프, 형식은 매번 새로 써요. 그래서 모든 영상이 자기만의 스코어를 받아요.
+
+- **건반:** 실제 스타인웨이 그랜드를 바탕으로 모델링한 피아노, 로즈와 워리처 전자 피아노, 톤휠 오르간과 파이프 오르간, 건반 타악기와 종.
+- **앙상블:** 연주자마다 따로 연주하는 현악 섹션, 금관, 플루트와 클라리넷, 모음을 불러내는 합창, 나일론·스틸·일렉트릭 기타, 하프, 네 가지 베이스.
+- **드럼:** 코드로 만든 진짜 드럼 키트(어쿠스틱, 808, 909, 더스티, 브러시, 팀파니가 있는 오케스트라). 한 번 칠 때마다 조금씩 달라요.
+- **진짜 로파이:** 12비트 샘플러, 테이프의 흔들림과 히스, 바이닐 잡음, 믹스를 숨 쉬게 하는 킥.
+- **믹스와 공간:** 파트별 EQ, 드럼 버스, 홀·플레이트·컨볼루션 리버브, 스트리밍 기준 음량으로 맞추는 마스터.
+
+`node tools/music.mjs check`는 사람이 듣기 전에 스코어를 검사해요. 조와 선법, 음량, 마스킹, 파트마다의 균형, 그리고 새로움까지요. 이미 있는 곡처럼 들리거나 그 곡을 인용한 스코어는 통과하지 못해요.
| 들어보기 | |
|---|---|
@@ -103,7 +111,7 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
| [영화 음악·경외감](assets/audio/sampler-cinematic-awe-8s.mp3) · [로파이](assets/audio/sampler-lofi-nostalgic-8s.mp3) · [마림바](assets/audio/sampler-marimba-curious-8s.mp3) · [일렉트로닉](assets/audio/sampler-drive-electronic-8s.mp3) | 더 많은 분위기와 악기 |
| [15초로 맞춘 녹턴 주제](assets/audio/fit-theme-15s.mp3) | 작곡기가 길이에 맞는 형식을 골라요 |
-그리고 **로파이 일렉트로닉**도 있어요. 따뜻하게 디튠한 패드, 부드럽게 튕기는 리드, 살짝 흔들리는 테이프 질감으로 차분하면서도 경쾌해요 (런칭 영상의 음악도 이 스타일로 작곡했어요. [어휘](skills/anidoodle/references/music/styles/lofi-electronic.md)). **효과음 키트**도 있어요. 여러 겹으로 만든 시드 기반 효과음 열네 가지가 정확한 프레임에 맞춰 울리고, 그때마다 음악이 살짝 물러나요 ([사운드 디자인](skills/anidoodle/references/music/sound-design.md)). 스타일은 작곡에 쓰는 어휘일 뿐, 미리 만들어 둔 음표가 아니에요. 모든 영상은 그 영상을 위해 쓴 스코어를 받아요.
+**효과음 키트**도 있어요. 여러 겹으로 만든 시드 기반 효과음 열네 가지가 정확한 프레임에 맞춰 울리고, 그때마다 음악이 살짝 물러나요 ([사운드 디자인](skills/anidoodle/references/music/sound-design.md)). 스코어를 만드는 방법: [`compose.md`](skills/anidoodle/references/music/compose.md) · [21가지 어휘](skills/anidoodle/references/music/styles/vocabularies.md).
## 나를 알아채는 웹페이지
@@ -115,7 +123,14 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
## 내 제품을 코드로 그려서 런칭하기
-이 페이지 맨 위의 영상은 anidoodle로 만들었고, 그때 쓴 키트도 함께 들어 있어요. 제품 이름, 사용자가 입력할 프롬프트, 그 답이 될 그림, 짧은 문구, 설치 명령어를 넘겨주면 박자에 맞춰 런칭 영상을 편집해요. 스스로 입력되는 채팅, 잉크처럼 번지며 열리고 저절로 그려지는 답, 화면을 가득 채우는 레터링, 그리고 설치 명령어를 복사할 수 있을 만큼 오래 보여주는 엔드 카드까지요.
+이 페이지 맨 위의 영상은 anidoodle로 만들었고, 그때 쓴 키트도 함께 들어 있어요. `launch.mjs new <이름>`을 실행하면 채워 넣을 스펙이 생겨요. 제품 이름, 사용자가 입력할 프롬프트, 그 답(그린 그림, 내 제품의 화면, 또는 영상), 짧은 문구, 설치 명령어를 넣으면 박자에 맞춰 런칭 영상을 편집해요. 스스로 입력되는 채팅, 잉크처럼 번지며 열리는 답, 화면을 가득 채우는 레터링, 그리고 설치 명령어를 복사할 수 있을 만큼 오래 보여주는 엔드 카드까지요.
+
+- **네 가지 화면비, 하나의 타임라인:** 16:9, 1:1, 4:5, 9:16. 화면비마다 다시 구성하고, 휴대폰에서도 글자가 잘 읽혀요.
+- **내 제품을 화면에:** 데이터로 그린 인터페이스에서 항목들이 이전 상태에서 이후 상태로 통통 튀며 옮겨 가요.
+- **그림에서 나오는 소리:** 키 입력, 클릭, 착지마다 효과음이 붙고, 화면에서 일어난 자리에서 들려요. 그 아래에는 영상을 위해 작곡한 스코어가 흘러요.
+- **바로 올릴 수 있게:** `launch.mjs ship <이름>`이 화면비마다 렌더링하고, 포스터 프레임과 자막(.srt, .vtt)을 만들고, 납품 파일에서 음성과 영상의 싱크와 피크 레벨을 확인하고, 화면 가장자리에 글자가 잘리는 프레임은 실패로 처리해요.
+
+룩은 두 가지(손으로 그린 잉크, 또는 UI 중심 제품을 위한 클린)이고, 30 fps나 60 fps에 프레임마다 속도에 맞춘 모션 블러가 들어가요.
규칙은 저희 런칭 영상을 네 번 편집하며 얻은 경험과 잘 만든 런칭 영상들의 기술에서 왔어요. 5초 안에 무엇인지 말하기, 그림 위에 글자를 올리지 않기, 강박에서 전환하기, 첫 프레임을 썸네일로 만들기. → [`launch-video.md`](skills/anidoodle/references/workflows/launch-video.md) · [키트](skills/anidoodle/references/workflows/launch-video-kit.md)
@@ -160,7 +175,7 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
- **스토리**는 모든 작품에 의미를 줘요. 스틸컷 하나에는 아이디어 하나와 초점이 되는 소재 하나, 영화에는 하나의 변화와 하나의 결말, 그리고 되돌아오는 상징 하나. → [`storytelling.md`](skills/anidoodle/references/storytelling.md)
- **사실감**은 이름을 붙이는 데서 나와요. 해부 구조, 시점, 그리고 펼쳐본 레퍼런스까지 정확히 짚어야, 나비 한 마리도 몸과 날개맥을 가진 생명체로 읽혀요. → [`realism-and-craft.md`](skills/anidoodle/references/realism-and-craft.md)
- **스타일**은 선 하나하나에 깃들어요. 31가지 완전한 레시피, 작업에 맞게 하나를 고르는 가이드, 그리고 나만의 스타일을 만드는 방법까지. → [`styles.md`](skills/anidoodle/references/styles.md)
-- **음악**은 음표로 작곡하고 코드로 합성해요. 모델링한 피아노와 십여 가지 악기, 모든 장조와 단조, 구간별 분위기, 어떤 길이에도 맞는 테마까지 갖췄어요. → [`music/README.md`](skills/anidoodle/references/music/README.md)
+- **음악**은 스타일의 어휘로 작품마다 작곡하고 코드로 합성해요. 21가지 스타일, 밴드와 오케스트라 전체, 모든 장조와 단조, 구간별 분위기, 어떤 길이에도 맞는 테마까지 갖췄어요. → [`music/README.md`](skills/anidoodle/references/music/README.md)
- **결정론**은 우리의 보증이에요. 순수 함수와 시드값 기반 난수를 쓰니까, 소스만 있으면 누구든 완전히 똑같은 작품을 다시 만들어낼 수 있어요. → [`determinism-and-contract.md`](skills/anidoodle/references/determinism-and-contract.md)
- **작업 방식**이 속도를 지켜줘요. 스틸컷 하나로 룩을 먼저 검증하고, 그다음은 막힘없이 쭉 밀고 나가고, 틀렸을 때 비용이 큰 지점에서만 승인을 받는 식으로요. → [`working-method.md`](skills/anidoodle/references/working-method.md)
@@ -228,6 +243,8 @@ node tools/render.mjs intro --out out/intro.gif # a loop; also .mp4 w
node tools/emit.mjs intro --out out/intro.html # the whole piece as one offline file
node tools/gate.mjs hero # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4 # the file you ship, decoded and checked
+node tools/music.mjs check score.ts#myScore # your score: key, loudness, balance, novelty
+node tools/launch.mjs new myLaunch # a launch film spec; then: launch.mjs ship myLaunch
```
Node 20 이상이 필요해요. 스틸컷은 위에서 설치한 브라우저만 있으면 되고, 움직이는 건 전부 `ffmpeg`도 함께 써요.
diff --git a/README.md b/README.md
index dbcf236..48d57bd 100644
--- a/README.md
+++ b/README.md
@@ -94,7 +94,15 @@ Every style ships the finished picture and, from the same source, a film of it b
## Music, composed in code
-No samples and no recordings. The notes are written as data, and every sound is synthesized: a modelled piano (strings that beat, hammers that brighten, a pedal that rings), marimba, harp, guitar, celesta, bells, strings, chiptune and drums. Every major and minor mode, a mood per section, and a theme that fits itself to any length.
+No samples and no recordings. The notes are written as data and every sound is synthesized in code. A music style is a vocabulary the model composes from, never a preset: 21 of them, from lo-fi electronic, house and synthwave to orchestral, jazz, folk and solo piano. Each gives the sound, the grooves and the harmony language; the chords, the motif and the form are written new, so every film gets its own score.
+
+- **Keys:** a piano modelled on a real Steinway grand, Rhodes and Wurlitzer electric pianos, tonewheel and pipe organs, mallets and bells.
+- **Ensemble:** string sections of separate players, brass, flute and clarinet, a choir that sings its vowels, nylon, steel and electric guitars, harp and four kinds of bass.
+- **Drums:** real kits in code (acoustic, 808, 909, dusty, brushes, orchestral with timpani), every hit a little different.
+- **Real lo-fi:** a 12-bit sampler, tape wobble and hiss, vinyl crackle and a kick that makes the mix breathe.
+- **Mix and room:** per-part EQ, a drum bus, hall, plate and convolution reverbs, and a master at streaming loudness.
+
+`node tools/music.mjs check` clears a score before anyone listens: key and mode, loudness, masking, the balance of every part, and novelty, which fails a score that sounds like a known one or quotes it.
| Listen | |
|---|---|
@@ -103,7 +111,7 @@ No samples and no recordings. The notes are written as data, and every sound is
| [Cinematic, awe](assets/audio/sampler-cinematic-awe-8s.mp3) · [Lo-fi](assets/audio/sampler-lofi-nostalgic-8s.mp3) · [Marimba](assets/audio/sampler-marimba-curious-8s.mp3) · [Electronic](assets/audio/sampler-drive-electronic-8s.mp3) | more moods and instruments |
| [The nocturne's theme in 15 seconds](assets/audio/fit-theme-15s.mp3) | the composer picks the form that fits the length |
-Also in the box: **lo-fi electronic**, chill and upbeat, with warm detuned pads, a soft plucked lead and a little tape wobble (the launch film's score was composed in it; [the vocabulary](skills/anidoodle/references/music/styles/lofi-electronic.md)), and a **sound-effects kit**: fourteen layered, seeded effects cued to the exact frame, the score ducking under each one ([sound design](skills/anidoodle/references/music/sound-design.md)). A style is a vocabulary to compose from, never ready-made notes: every film gets a score written for it.
+Also in the box: a **sound-effects kit**, fourteen layered, seeded effects cued to the exact frame, the score ducking under each one ([sound design](skills/anidoodle/references/music/sound-design.md)). How a score is composed: [`compose.md`](skills/anidoodle/references/music/compose.md) · [the 21 vocabularies](skills/anidoodle/references/music/styles/vocabularies.md).
## Web pages that notice you
@@ -115,7 +123,14 @@ Interactive illustrations for real sites: a mascot that follows the cursor and r
## Launch your product, drawn in code
-The film at the top of this page was made with anidoodle, and the kit it was made with ships with it. Give it your product's name, the prompts a user would type, the pictures that answer them, a few words and your install lines. It cuts a launch film on the beat: a chat that types itself, answers that bloom open and draw themselves, full-frame lettering, and an end card that holds your install lines long enough to copy.
+The film at the top of this page was made with anidoodle, and the kit it was made with ships with it. `launch.mjs new <name>` gives you a spec to fill: your product's name, the prompts a user would type, the answers (a drawn picture, your product's own screens, or a film), a few words and your install lines. It cuts a launch film on the beat: a chat that types itself, answers that bloom open, full-frame lettering, and an end card that holds your install lines long enough to copy.
+
+- **Four shapes, one timeline:** 16:9, 1:1, 4:5 and 9:16, each re-composed for its frame with type that stays legible on a phone.
+- **Your product on screen:** its interface drawn from data, items springing from the before state to the after.
+- **Sound from the picture:** every key, press and landing gets its own effect, placed where it happens on screen, over a score composed for the film.
+- **Ready to post:** `launch.mjs ship <name>` renders every shape with its poster frame and captions (.srt and .vtt), checks audio-to-video sync and peak level on the file you deliver, and fails any frame whose edge cuts off text.
+
+Two looks (drawn ink, or clean for a UI-first product), at 30 or 60 fps, with motion blur matched to each frame's speed.
The rules come from four cuts of our own launch and from the craft of the best ones out there: say what it is within five seconds, never put words over the art, cut on the downbeat, make the first frame the thumbnail. → [`launch-video.md`](skills/anidoodle/references/workflows/launch-video.md) · [the kit](skills/anidoodle/references/workflows/launch-video-kit.md)
@@ -160,7 +175,7 @@ The engine is the easy half. The craft is the part anidoodle carries for you, si
- **Story** gives every piece a point. One idea and one focal subject for a still; one transformation, one payoff and one returning token for a film. → [`storytelling.md`](skills/anidoodle/references/storytelling.md)
- **Realism** comes from naming it. The anatomy, the view and the reference you opened, so a butterfly reads as a creature with a body and veins. → [`realism-and-craft.md`](skills/anidoodle/references/realism-and-craft.md)
- **Style** lives in the mark. Thirty-one full recipes, a guide for picking one per job, and the steps for inventing your own. → [`styles.md`](skills/anidoodle/references/styles.md)
-- **Music** is composed as notes and synthesized in code: a modelled piano and a dozen instruments, every major and minor mode, moods per section, and a theme that fits any length. → [`music/README.md`](skills/anidoodle/references/music/README.md)
+- **Music** is composed for each piece from a style's vocabulary and synthesized in code: 21 styles, a full band and orchestra, every major and minor mode, moods per section, and a theme that fits any length. → [`music/README.md`](skills/anidoodle/references/music/README.md)
- **Determinism** is the guarantee. Pure functions and a seeded random, so anyone with the source rebuilds the exact same piece. → [`determinism-and-contract.md`](skills/anidoodle/references/determinism-and-contract.md)
- **Method** keeps you fast. Prove the look on one still, build straight through, and spend approval where being wrong is expensive. → [`working-method.md`](skills/anidoodle/references/working-method.md)
@@ -228,6 +243,8 @@ node tools/render.mjs intro --out out/intro.gif # a loop; also .mp4 w
node tools/emit.mjs intro --out out/intro.html # the whole piece as one offline file
node tools/gate.mjs hero # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4 # the file you ship, decoded and checked
+node tools/music.mjs check score.ts#myScore # your score: key, loudness, balance, novelty
+node tools/launch.mjs new myLaunch # a launch film spec; then: launch.mjs ship myLaunch
```
Node 20 or newer. Stills need only the browser above; anything that moves also uses `ffmpeg`.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 4108880..8cef8d3 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -94,7 +94,15 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
## 用代码谱写音乐
-没有采样,也没有录音。音符写成数据,所有声音都由代码合成:模拟钢琴的琴弦拍频、随力度变亮的琴槌音色和延续的踏板共鸣,还有马林巴、竖琴、吉他、钢片琴、钟声、弦乐、芯片音色和鼓。覆盖所有大调与小调,每一段可以有自己的情绪,主题也能适配任意时长。
+没有采样,也没有录音。音符写成数据,所有声音都由代码合成。音乐风格是模型用来作曲的词汇,从来不是预设:共 21 种,从低保真电子、House、合成器浪潮到管弦乐、爵士、民谣和钢琴独奏。风格提供音色、律动和和声语言;和弦、动机和曲式每次都重新写,所以每部片子都有自己的配乐。
+
+- **键盘:** 以一台真实的施坦威三角钢琴为原型建模的钢琴,Rhodes 和 Wurlitzer 电钢琴,音轮风琴和管风琴,槌击乐器和钟。
+- **合奏:** 每位乐手独立演奏的弦乐组,铜管,长笛和单簧管,会唱出元音的合唱团,尼龙弦、钢弦和电吉他,竖琴和四种贝斯。
+- **鼓:** 用代码做出的真实鼓组(原声、808、909、复古颗粒、鼓刷、带定音鼓的管弦乐),每一击都略有不同。
+- **真正的低保真:** 12 位采样器、磁带的晃动与底噪、黑胶的噼啪声,以及让整个混音呼吸起来的底鼓。
+- **混音与空间:** 分轨均衡、鼓组总线、大厅、板式和卷积混响,以及达到流媒体响度标准的母带。
+
+`node tools/music.mjs check` 在任何人试听之前先审核配乐:调性与调式、响度、掩蔽、每个声部的平衡,以及新颖度。听起来像已有曲子或引用了它的配乐不会通过。
| 试听 | |
|---|---|
@@ -103,8 +111,7 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
| [电影感·敬畏](assets/audio/sampler-cinematic-awe-8s.mp3) · [低保真](assets/audio/sampler-lofi-nostalgic-8s.mp3) · [马林巴](assets/audio/sampler-marimba-curious-8s.mp3) · [电子乐](assets/audio/sampler-drive-electronic-8s.mp3) | 更多情绪与乐器 |
| [15 秒版夜曲主题](assets/audio/fit-theme-15s.mp3) | 作曲器会选择适合时长的曲式 |
-另外还有**低保真电子乐**:温暖的失谐铺底、轻柔的拨弦主旋律和一点磁带晃动,放松又轻快(发布片的配乐就是用这种风格创作的,[词汇表](skills/anidoodle/references/music/styles/lofi-electronic.md));
-以及**音效套件**:十四种分层、带种子的音效,精确到帧触发,每一次音乐都会让开一点([声音设计](skills/anidoodle/references/music/sound-design.md))。风格是用来作曲的词汇,从来不是现成的音符:每部片子都有专门为它写的配乐。
+以及**音效套件**:十四种分层、带种子的音效,精确到帧触发,每一次音乐都会让开一点([声音设计](skills/anidoodle/references/music/sound-design.md))。配乐怎么写:[`compose.md`](skills/anidoodle/references/music/compose.md) · [21 种词汇](skills/anidoodle/references/music/styles/vocabularies.md)。
## 会注意到你的网页
@@ -116,7 +123,14 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
## 用代码画出你的产品发布片
-本页顶部的影片就是用 anidoodle 做的,做它的那套工具也一起附带。给它你的产品名、用户会输入的提示、回应这些提示的画面、几个词和你的安装命令,它就会踩着节拍剪出一支发布片:自己打字的聊天界面、像墨迹一样绽开并自己画出来的回答、整屏的手写字,以及一张把安装命令停留足够久、方便复制的结尾卡。
+本页顶部的影片就是用 anidoodle 做的,做它的那套工具也一起附带。`launch.mjs new <名称>` 会给你一份待填写的规格:你的产品名、用户会输入的提示、对应的回答(一幅画出来的图、你自己产品的界面,或一段影片)、几个词和你的安装命令。它会踩着节拍剪出一支发布片:自己打字的聊天界面、像墨迹一样绽开的回答、整屏的手写字,以及一张把安装命令停留足够久、方便复制的结尾卡。
+
+- **四种画幅,一条时间线:** 16:9、1:1、4:5 和 9:16,每种画幅都重新构图,文字在手机上也清晰可读。
+- **把你的产品搬上屏幕:** 由数据画出的界面,元素从修改前的状态弹跳到修改后的状态。
+- **声音来自画面:** 每一次按键、点击和落地都有自己的音效,出现在屏幕上发生的位置,下面是为这支片子作曲的配乐。
+- **可以直接发布:** `launch.mjs ship <名称>` 渲染每种画幅,写出封面帧和字幕(.srt 与 .vtt),在交付的文件上检查音画同步和峰值电平,并让任何边缘切到文字的帧不通过。
+
+两种风格(手绘墨迹,或为以界面为主的产品准备的简洁风格),30 或 60 fps,运动模糊按每一帧的速度调整。
这些规则来自我们自己发布片的四次剪辑,以及优秀发布片的手艺:五秒内说清它是什么,文字永远不压在画面上,在强拍上切换,把第一帧做成缩略图。 → [`launch-video.md`](skills/anidoodle/references/workflows/launch-video.md) · [工具包](skills/anidoodle/references/workflows/launch-video-kit.md)
@@ -161,7 +175,7 @@ https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da
- **故事**,让每件作品都有一个重点。一张静态图只讲一个想法、聚焦一个主体;一部短片只有一次转变、一个高潮,和一个反复出现的意象。→ [`storytelling.md`](skills/anidoodle/references/storytelling.md)
- **写实感**,来自把它说清楚。解剖结构、观察视角,以及你参考过的资料,都要交代明白,这样一只蝴蝶读起来才像是一个有身体、有翅脉的真实生物。→ [`realism-and-craft.md`](skills/anidoodle/references/realism-and-craft.md)
- **风格**,活在笔触里。31 套完整配方,外加一份按场合挑风格的指南,以及自创风格的步骤。→ [`styles.md`](skills/anidoodle/references/styles.md)
-- **音乐**,先写成音符,再由代码合成:建模钢琴和十余种乐器、所有大小调、每个段落各自的情绪,以及能适配任意时长的主题旋律。→ [`music/README.md`](skills/anidoodle/references/music/README.md)
+- **音乐**,依照某种风格的词汇为每件作品作曲,再由代码合成:21 种风格、完整的乐队和管弦乐团、所有大小调、每个段落各自的情绪,以及能适配任意时长的主题旋律。→ [`music/README.md`](skills/anidoodle/references/music/README.md)
- **确定性**,是这套系统的承诺。纯函数加上带种子的随机数,任何人拿到源码都能重建出一模一样的作品。→ [`determinism-and-contract.md`](skills/anidoodle/references/determinism-and-contract.md)
- **方法**,让你保持速度。先用一张静态图验证效果,再一路做到底,把审批环节留给那些出错代价高的地方。→ [`working-method.md`](skills/anidoodle/references/working-method.md)
@@ -229,6 +243,8 @@ node tools/render.mjs intro --out out/intro.gif # a loop; also .mp4 w
node tools/emit.mjs intro --out out/intro.html # the whole piece as one offline file
node tools/gate.mjs hero # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4 # the file you ship, decoded and checked
+node tools/music.mjs check score.ts#myScore # your score: key, loudness, balance, novelty
+node tools/launch.mjs new myLaunch # a launch film spec; then: launch.mjs ship myLaunch
```
需要 Node 20 及以上版本。静态图只需要上面那个浏览器;只要涉及动态效果,就还会用到 `ffmpeg`。
diff --git a/scripts/plugin-README.md b/scripts/plugin-README.md
index af85749..e29cf34 100644
--- a/scripts/plugin-README.md
+++ b/scripts/plugin-README.md
@@ -4,6 +4,8 @@
anidoodle makes illustrations, drawing timelapses, films of any length, explainers, infographics and interactive web animations in 31 hand-made styles, with original music composed and synthesized in code. Ask for a picture in plain words, match a style from your own image, recreate a photo in any style, keep a character consistent across scenes, or learn step by step how a drawing is built.
+Music is composed for each piece from 21 style vocabularies, never presets, and played by a sound engine built in code: a piano modelled on a real Steinway, Rhodes and Wurlitzer, orchestral sections and choir, guitars, real drum kits, real lo-fi, a full mix with reverb. `music.mjs check` clears a score (key, loudness, balance, novelty) before anyone listens. The launch kit turns your product's prompts, screens and install lines into a launch film in four shapes (16:9, 1:1, 4:5, 9:16), with sound cued from the picture, captions and a sync check; `launch.mjs new` starts one and `launch.mjs ship` delivers every shape.
+
Every mark is a function and every note is arithmetic, so the same source redraws the same picture on every machine, at every size. There are no generated image assets and no image model calls.
Works in Claude Code, Codex and Grok Build, and in any agent that reads skills. It needs Node 20 or newer on your machine; films also use ffmpeg.
diff --git a/skills/anidoodle/SKILL.md b/skills/anidoodle/SKILL.md
index c954963..d401bbe 100644
--- a/skills/anidoodle/SKILL.md
+++ b/skills/anidoodle/SKILL.md
@@ -124,7 +124,7 @@ node tools/emit.mjs intro --out out/intro.html # one self-co
| `verify-export.mjs` | QA on the rendered file: frames, duration, score, A/V sync, true peak after the encode; opt-in first frame, loop seam, `--delivery` |
| `launch.mjs` | a launch film: `new <name>` scaffolds the spec; `ship <name> --shapes 16x9,9x16` renders, posters, captions, verifies and framechecks each (`framecheck.mjs`: no text cut by the frame's edge) |
| `test.mjs` (`npm test`) | unit suites in `engine/test/`, no browser |
-| `music.mjs` | `vocab` prints a style's vocabulary; `check` gates your composed score; `render`, `meter` |
+| `music.mjs` | `vocab` prints a style's vocabulary; `check` gates your composed score (key, master, guards, stems, novelty); `render`, `meter` |
| `sfx.mjs` | the sound-effects kit: `list`, `one`, `kit <dir>`, `test` |
Four backends, one art core: `playwright`, `html-player`, `remotion`, `hyperframes`.
diff --git a/skills/anidoodle/engine/package-lock.json b/skills/anidoodle/engine/package-lock.json
index 02a7c25..a1c0c85 100644
--- a/skills/anidoodle/engine/package-lock.json
+++ b/skills/anidoodle/engine/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "anidoodle-engine",
- "version": "0.5.3",
+ "version": "0.6.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "anidoodle-engine",
- "version": "0.5.3",
+ "version": "0.6.0",
"dependencies": {
"esbuild": "0.25.12"
},
diff --git a/skills/anidoodle/engine/package.json b/skills/anidoodle/engine/package.json
index 99b0c66..8a5aa81 100644
--- a/skills/anidoodle/engine/package.json
+++ b/skills/anidoodle/engine/package.json
@@ -1,6 +1,6 @@
{
"name": "anidoodle-engine",
- "version": "0.5.3",
+ "version": "0.6.0",
"private": true,
"type": "module",
"description": "Portable art core + backend adapters for illustrations, animations and films drawn entirely in code.",