Skip to content

deckctl theme

Handles theme lifecycle. Themes are persisted to themes.yaml — see the configuration reference.

deckctl theme [command] [flags]
SubcommandPurpose
listList available themes
getShow one theme
activeShow the active theme
addAdd a theme
setMake a theme active
removeRemove a theme

All subcommands also accept the global flags.

Table columns for list, get and active: Name, Primary, Secondary, Accent, Muted.


deckctl theme list [flags]

No command-specific flags.

Terminal window
deckctl theme list
deckctl theme list -o json

deckctl theme get [name] [flags]
Terminal window
deckctl theme get solarized

deckctl theme active [flags]

Prints the currently active theme. If no themes.yaml exists, deckctl uses a built-in default palette.

Terminal window
deckctl theme active

deckctl theme add [flags]
FlagDescription
-n, --name <name>Theme name (must be unique)
-p, --primary <hex>Primary colour
-s, --secondary <hex>Secondary colour
-a, --accent <hex>Accent colour
-m, --muted <hex>Muted colour

All four colours are required and must be hex — #rgb or #rrggbb. Run with no flags to be prompted.

Terminal window
deckctl theme add --name solarized \
--primary "#93a1a1" --secondary "#268bd2" \
--accent "#b58900" --muted "#586e75"

deckctl theme set [name] [flags]

Sets active in themes.yaml. The name must exist in the themes list.

Terminal window
deckctl theme set solarized

deckctl theme remove [flags]
FlagDefaultDescription
-n, --name <name>Theme to remove
--auto-approvefalseSkip the confirmation prompt
Terminal window
deckctl theme remove --name solarized
deckctl theme remove --name solarized --auto-approve