3D Chladni Render

Workflow

1. Resolve the requested workspace, output path, duration, dimensions, and visual mode.
2. Use

   cosmic

   when the user does not choose a mode.
3. Pass an audio file with

   --audio

   when the user wants sound-reactive motion. Prefer

   sand

   or

   dcosmic

   for audio-driven output.
4. Resolve the installed skill directory and run

   scripts/render_3d_chladni.py

   .
5. Wait for the script to print

   VALIDATION=PASS

   and

   OUTPUT_VIDEO=<absolute path>

   .
6. Return the absolute output path and the render settings.

Quick Start

python3 scripts/render_3d_chladni.py \
  --workspace "$(pwd)" \
  --output "$(pwd)/out/3d-chladni-cosmic.mp4"

Installed Skill Resolution

skill_dir=""
for base in "${AGENTS_HOME:-$HOME/.agents}" "${CLAUDE_HOME:-$HOME/.claude}" "${CODEX_HOME:-$HOME/.codex}"; do
  if [ -d "$base/skills/3d-chladni-render" ]; then
    skill_dir="$base/skills/3d-chladni-render"
    break
  fi
done
[ -n "$skill_dir" ] || { echo "3d-chladni-render skill not found under ~/.agents, ~/.claude, or ~/.codex"; exit 1; }

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --output "$(pwd)/out/3d-chladni-cosmic.mp4"

Modes

--style

sand

msand

cosmic

dcosmic

Audio-Driven Render

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --style dcosmic \
  --audio "/absolute/path/to/music.wav" \
  --seconds 12 \
  --output "$(pwd)/out/audio-chladni.mp4"

Transparent Output

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --alpha \
  --output "$(pwd)/out/3d-chladni-alpha.mov"

Behavior

• Accept either a parent workspace or an existing 3D Chladni checkout through

  --workspace

  .
• Clone

  https://github.com/nolangz/3D-Chladni.git

  into

  <workspace>/3D-Chladni

  when absent.
• Fetch and fast-forward the selected branch when the checkout is clean.
• Refuse to update a dirty checkout; use

  --skip-update

  to preserve intentional local edits.
• Install project dependencies with

  npm ci

  only when Electron is missing, unless

  --skip-install

  is set.
• Invoke the repository's pixel-exact Electron exporter instead of screen-recording the live page.
• Default to 1280×720, 30 fps, 6 seconds, 15% particles, sweep lighting, and precession.
• Use deterministic seeds so reruns with the same settings reproduce the same particle motion.
• Accept

  .mp4

  for H.264 and

  .mov

  for ProRes; require

  .mov

  when

  --alpha

  is used.
• Validate the finished container with

  ffprobe

  , including dimensions, duration, and audio-stream presence when

  --audio

  is supplied.
• Pass

  --pattern /absolute/path/pattern.json

  to render a saved Chladni pattern.

Requirements

• git

• Python 3.9+
• Node.js and

  npm

• ffmpeg

  and

  ffprobe

• Network access for the initial clone and dependency installation

Preview Asset License

assets/3d-chladni-cosmic.gif