Audio

The Audio tab provides test tone generators for verifying your audio output path. Use these to confirm that audio is flowing correctly through your hardware before recording or performing.

Open Settings with ⌘, (macOS) or Ctrl+, (Windows/Linux), then select Audio in the sidebar.

⚠️ Warning: Lower your speaker/headphone volume before enabling test tones!

Test Tone Generators

White Noise

Broadband noise useful for checking output levels, speaker response, and confirming that audio playback is working.

Setting	Type	Default	Storage Key	Description
Enabled	toggle	Off	—	Turn white noise generator on/off
Volume	slider (0.0–1.0)	0.5	`audio.test.white_noise_volume`	Output level (displayed in dB)

Sine Wave

A pure tone at a selectable frequency. Useful for testing specific frequency ranges, calibrating monitors, or checking for distortion.

Setting	Type	Default	Storage Key	Description
Enabled	toggle	Off	—	Turn sine wave generator on/off
Volume	slider (0.0–1.0)	0.5	`audio.test.sine_volume`	Output level (displayed in dB)
Frequency	dropdown	440 Hz (A4)	`audio.test.sine_frequency`	Tone frequency

Available Frequencies

Value	Label
20 Hz	20 Hz
50 Hz	50 Hz
100 Hz	100 Hz
200 Hz	200 Hz
440 Hz	440 Hz (A4)
1000 Hz	1 kHz
5000 Hz	5 kHz
10000 Hz	10 kHz
15000 Hz	15 kHz
20000 Hz	20 kHz

Volume Display

Volume sliders display the level in decibels (dB). The conversion from slider position to dB is:

0.0 → −∞ dB (silent)
0.5 → −6.0 dB (default)
1.0 → 0.0 dB (full scale)

The formula is: dB = 20 × log10(volume) where volume is the 0.0–1.0 slider value.

Lua API

-- Set white noise volume (0.0 to 1.0)
pl.cmd("settings:set", { key = "audio.test.white_noise_volume", value = "0.5" })

-- Set sine wave volume
pl.cmd("settings:set", { key = "audio.test.sine_volume", value = "0.7" })

-- Set sine wave frequency in Hz
pl.cmd("settings:set", { key = "audio.test.sine_frequency", value = "1000" })

Command	Description
`settings:set`	Set a user setting by key
`settings:open`	Open settings panel