Configuration

Configuration

deckd uses TOML configuration. Default path: /etc/deckd/config.toml.

Global Settings

[deckd]
brightness = 80              # Display brightness 0-100
reconnect_interval_ms = 2000 # USB reconnect interval
home_page = "home"           # Starting page

[deckd.defaults]
background = "#1a1a2e"       # Default button background
text_color = "#e0e0e0"       # Default text color
font_size = 14               # Default font size in pixels

Pages and Buttons

[pages.home]
name = "Home"

[[pages.home.buttons]]
key = 0                      # Key index 0-14
label = "Deploy"
icon = "icons/rocket.png"    # Relative to config dir
background = "#c0392b"       # Override default
on_press = { action = "http", method = "POST", url = "https://example.com/webhook" }

Key Layout (MK.2, 3x5)

 0  1  2  3  4
 5  6  7  8  9
10 11 12 13 14

Environment Variables

Use ${VAR} syntax in any string value:

headers = { "Authorization" = "Bearer ${HA_TOKEN}" }

Hot Reload

Edit the config file while deckd is running. Changes are automatically detected and applied without restart.