Locations

Configure where Plinken stores projects, recordings, and data files.

Open from Settings > Locations (keyboard shortcut: Cmd+, then select the Locations tab).

Settings

Setting	Type	Editable	Description
Plinken Document Root	path	Yes	Root folder for projects and recordings
Database Path	path	No	SQLite database location (read-only, set in config file)
Extensions	path	Yes	Directory for downloaded AI models and plugins

Plinken Document Root

The document root is where Plinken stores all projects and recordings. Each project gets its own subfolder within this directory.

• Type or paste a path, or click Browse to open a file picker
• Changes take effect immediately — no restart required
• The path is displayed in a text input; for long paths, the end (most relevant part) is shown

Default Location

On macOS: ~/Documents/Plinken/

Storage Key

projects.default_path

Database Path

The SQLite database stores user settings, project metadata, and session state. This path is read-only in the UI — it’s configured in the application config file and requires a restart to change.

The config file location is shown as help text below the field (typically ~/.plinken/config.json or platform equivalent).

Extensions

The extensions directory stores downloaded AI models, plugins, and other extension files. Click Set after editing the path to apply changes.

Default Location

The default extensions directory is determined by the platform’s standard application support directory.

Lua API

-- Get the document root path
local root = pl.cmd("settings:get", { key = "projects.default_path" })

-- Set a new document root
pl.cmd("settings:set", { key = "projects.default_path", value = "/Users/me/Music/Plinken" })

All Storage Keys

Key	Type	Default	Description
projects.default_path	string	""	Document root for projects
projects.auto_save_seconds	int	60	Auto-save interval (0 = disabled)

See Also

• Settings Overview
• Cache — manage cached waveform data
• API Keys — configure AI service credentials