Export WAV
TheuseExportWav hook renders your playlist to WAV format using OfflineAudioContext for fast, non-real-time rendering.
Basic Usage
packages/browser/src/hooks/useExportWav.ts
Hook Interface
packages/browser/src/hooks/useExportWav.ts:49-61
Export Options
packages/browser/src/hooks/useExportWav.ts:13-37
Master Mix Export
Export the entire mix as a stereo WAV:- Track volume and pan
- Solo/mute state
- Clip fades
- Clip positioning and trimming
packages/browser/src/hooks/useExportWav.ts:87
Individual Track Export
Export a single track:packages/browser/src/hooks/useExportWav.ts:88-89
Exporting with Master Effects
Apply master effects during export usingTone.Offline:
createOfflineEffectsFunction() creates fresh effect instances in the offline context, avoiding AudioContext mismatch.
Location: packages/browser/src/hooks/useExportWav.ts:146-161
Exporting with Per-Track Effects
packages/browser/src/hooks/useExportWav.ts:32-34
Combining Master and Track Effects
Bit Depth Options
packages/browser/src/hooks/useExportWav.ts:93
Progress Tracking
packages/browser/src/hooks/useExportWav.ts:36
Custom Download Handling
Disable auto-download to handle the blob yourself:packages/browser/src/hooks/useExportWav.ts:89
Solo/Mute Handling
packages/browser/src/hooks/useExportWav.ts:138-139
Fade Support
Exports respect clip fades:linear: Straight line rampexponential: Curved exponential ramplogarithmic: Inverse exponentialsCurve: Smooth ease-in-out
packages/browser/src/hooks/useExportWav.ts:433-473
Rendering with Tone.Offline
When effects are present, rendering usesTone.Offline:
packages/browser/src/hooks/useExportWav.ts:234-375
Error Handling
packages/browser/src/hooks/useExportWav.ts:99-106
Example: Complete Export UI
Important Notes
- Export uses OfflineAudioContext for fast rendering (faster than real-time)
- Effects must use
createOfflineEffectsFunctionto avoid AudioContext mismatch - Clips without
audioBuffer(peaks-only) are skipped - Total duration includes all clips plus 0.1s buffer
- Solo overrides mute (soloed tracks play even if muted)
Next Steps
- Audio Effects - Apply effects before export
- Multi-Track Editing - Arrange tracks
- Recording - Record and export