Settings

Open Settings with ⌘, (macOS) or Ctrl+, (Windows/Linux), or via Plinken → Preferences.

Settings are organized into tabs in a sidebar. All changes take effect immediately and persist across sessions in a local SQLite database.

Settings Tabs

Tab	Description
Account	Registration, login, subscription tier, and session diagnostics
Audio	Test tone generators (white noise, sine wave) for verifying audio output
Cache	Waveform cache management and storage cleanup
Display	Chat font size and AI model selection
Edit	Undo history depth
API Keys	API keys for AI providers (OpenAI, Anthropic, etc.)
Locations	File paths — document root, database, cache, and extensions directories
Metronome	Click volume, playback/recording toggles, count-in bars
MIDI	MIDI device routing — per-device MIDI, MC, MTC, and MMC toggles
Mouse	Scroll and zoom sensitivity, invert direction
Projects	Default project path and auto-save interval
Shortcuts	View and customize all keyboard shortcuts
Streaming	Live streaming to YouTube, Twitch, and Cloudflare (WHIP/RTMPS)
Sync	Timecode frame rate, start offset, and timing compensation

Keyboard Shortcut

Shortcut	Action
⌘, / Ctrl+,	Open Settings

Data Storage

User settings are stored in a local SQLite database using key-value pairs. Settings are not project-specific — they apply globally across all projects.

Settings keys follow a dotted namespace convention (e.g. audio.test.sine_frequency, metronome.volume, sync.input_compensation_ms).

Reading and Writing Settings

-- Set a setting value
pl.cmd("settings:set", { key = "metronome.volume", value = "0.8" })

-- Open settings to a specific tab
pl.cmd("settings:open", { tab = "audio" })

Key Reference

A complete list of setting keys and their defaults:

Key	Type	Default	Description
audio.test.white_noise_volume	float	0.5	White noise volume (0–1)
audio.test.sine_volume	float	0.5	Sine wave volume (0–1)
audio.test.sine_frequency	float	440.0	Sine wave frequency (Hz)
metronome.volume	float	0.7	Metronome click volume (0–1)
metronome.count_in_bars	int	1	Count-in bars (1, 2, or 4)
display.scale	float	1.0	UI scale factor
display.show_fps	bool	false	Show FPS counter
display.chat_font_size	float	24.0	Chat font size in retina pixels (24 = 12pt)
display.ai_model_index	int	0	AI model (0=Llama, 1=Qwen3, 2=QwQ)
edit.undo_steps	int	100	Undo history depth
mouse.scroll_sensitivity	float	1.0	Scroll sensitivity (0.5–2.0)
mouse.invert_scroll	bool	false	Invert scroll direction
mouse.zoom_sensitivity	float	1.0	Zoom sensitivity (0.5–2.0)
mouse.invert_zoom	bool	false	Invert zoom direction
projects.default_path	string	—	Default project save location
projects.auto_save_seconds	int	60	Auto-save interval (0 = disabled)
cache.path	string	—	Waveform cache directory
cache.max_size_mb	int	1024	Max cache size in MB
sync.input_compensation_ms	float	0.0	Input timing compensation (−10 to +10 ms)
sync.output_mtc_compensation_ms	float	0.0	Output MTC compensation (−50 to +50 ms)
sync.output_mc_compensation_ms	float	0.0	Output MC compensation (−50 to +50 ms)
mcp.server.enabled	bool	false	Enable MCP HTTP server
mcp.server.port	int	19560	MCP server port
remote.port	int	9100	iOS Remote config server port
remote.rtp_port	int	5004	RTP video listener UDP port
webserver.port	int	19570	Embedded web server port

Related Commands

Command	Description
settings:set	Set a user setting by key and value
settings:open	Open the settings panel (optionally to a tab)

See Also

• Automation — CC-to-parameter mapping
• Keyboard Shortcuts — Default shortcut reference