Configuration Reference

LazyDatabricks configuration file reference.

Config File Location

Default: ~/.lazydatabricks/config.toml

Theme Configuration

LazyDatabricks uses Textual's built-in themes by default, inheriting colors from your terminal. You can customize colors:

[theme]
# Built-in theme name (default: textual-ansi)
# Options: textual-ansi, textual-dark, textual-light, nord, gruvbox,
#          catppuccin-mocha, dracula, tokyo-night, monokai, solarized-dark
theme_name = "textual-ansi"

# Override specific colors (use hex values or Textual tokens)
accent = "#e94560"
background = "$background"

Available Theme Colors

Key	Description
`theme_name`	Base theme to use
`background`	Screen background
`surface`	Surface elements
`panel`	Panel backgrounds
`border`	Border colors
`text`	Primary text
`text_muted`	Dimmed text
`accent`	Accent/highlight color
`success`	Success state
`error`	Error state
`warning`	Warning state
`running`	Running state indicator
`stopped`	Stopped state indicator
`pending`	Pending state indicator
`armed`	Armed mode indicator
`disarmed`	Disarmed mode indicator

Extensions Configuration

Extensions are optional feature sets that can be enabled:

[extensions]
enabled = ["billing"]

[extensions.billing]
sql_warehouse_id = "abc123..."
default_window = "7d"

Billing Extension

The billing extension provides cost visibility using Databricks system tables.

Key	Required	Description
`sql_warehouse_id`	Yes	SQL Warehouse ID for queries
`default_window`	No	Default time window (e.g., "7d", "30d")

To configure the billing extension interactively:

lazydatabricks setup billing

Example Configuration

# ~/.lazydatabricks/config.toml

[theme]
theme_name = "catppuccin-mocha"
accent = "#f5c2e7"

[extensions]
enabled = ["billing"]

[extensions.billing]
sql_warehouse_id = "abc123def456"
default_window = "7d"