Advanced / Audio · guide

Audio — advanced workflows

Current Apexify.js 6.0.0 documentation for Audio — advanced workflows.

apexify.jsRuntime: nodeCURRENTSince 6.0.0

Procedural SFX with painter.createAudio — WAV Buffers on the server without sound files. Pair with video muxing or use standalone (games, bots, notifications).

FFmpeg audio on video (extractAudio, mixAudio, normalizeAudio, …) stays in the Video & FFmpeg feature guide — those are createVideo keys, not synthesis.

Reading order

Chapter	Topic
01 — `createAudio`	Presets, `synth`, `sequence`, `compose`, `mix`, `save`
Video pipeline	`videoPipeline().audio()` — file + `preset` / `sequence` / `wav` tracks
Video audio (FFmpeg)	`mixAudio`, `normalizeAudio`, strip/mute/duck on `createVideo`

When to use which API

Goal	API
Generate laser/coin/UI bleeps in code	`painter.createAudio`
Mux music or WAV onto one video file	`createVideo({ mixAudio })` — Video audio (FFmpeg)
Editor stack (trim + SFX + bed)	`videoPipeline().audio([...])` — Video pipeline
Only demux / normalize / strip existing soundtrack	`createVideo` — no `createAudio` needed

No FFmpeg required for createAudio itself (PCM → WAV). Muxing onto video needs ffmpeg on PATH.

Quick start

1const painter = new ApexPainter({ type: 'buffer' });2 3const coin = painter.createAudio.preset('coin');4await painter.createAudio.save(coin, './coin.wav');5 6const levelComplete = painter.createAudio.sequence({7  events: [8    { at: 0, preset: 'success' },9    { at: 0.2, preset: 'coin', gain: 0.9 },10    { at: 0.35, preset: 'powerup' },11  ],12  tail: 0.15,13});14 15await painter.createVideo({16  source: './gameplay.mp4',17  mixAudio: {18    outputPath: './gameplay-sfx.mp4',19    keepOriginalAudio: false,20    overlays: [{ source: levelComplete, startTime: 0 }],21  },22});

#Reading order

#When to use which API

#Quick start

Related guides and reference

Next steps

Reading order

When to use which API

Quick start