Metronome

The Metronome tab controls the click/metronome during playback and recording, its volume, and the count-in behavior before recording.

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

Settings

Setting	Type	Default	Storage Key	Description
Metronome During Playback	toggle	Off	`metronome_enabled`*	Enable click during normal playback
Metronome During Recording	toggle	On	`metronome_enabled`*	Enable click during recording
Volume	slider (0.0–1.0)	0.7 (≈ −3 dB)	`metronome.volume`	Click volume level
Count-In	toggle	Off	`count_in_enabled`*	Enable count-in bars before recording
Count-In Bars	dropdown	1 bar	`metronome.count_in_bars`	Number of count-in bars

* Metronome and count-in enabled states are stored in module.transport JSON.

Metronome During Playback

When enabled, the metronome clicks on every beat during normal playback. Useful for practicing parts or checking timing without recording.

Metronome During Recording

When enabled (the default), the metronome clicks during recording. Most users keep this on for timing reference while recording parts. You can disable it for ambient recordings or when monitoring an external click track.

Volume

The volume slider controls click loudness from silent to full scale:

0.0 → −∞ dB (silent)
0.7 → −3.1 dB (default — loud but not overpowering)
1.0 → 0.0 dB (full scale)

The dB value is displayed next to the slider.

Count-In

Count-in plays metronome clicks for a set number of bars before recording starts, giving you time to prepare. The count-in toggle enables/disables it independently from the bar count.

Count-In Options

Value	Label
1	1 bar
2	2 bars
4	4 bars

Lua API

-- Set metronome volume (0.0 to 1.0)
pl.cmd("settings:set", { key = "metronome.volume", value = "0.7" })

-- Set count-in bars (1, 2, or 4)
pl.cmd("settings:set", { key = "metronome.count_in_bars", value = "2" })

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