Theming
Atuin’s themes can be customized. Atuin ships with only a couple of built-in themes, but you can create your own themes.
To change the theme, set theme.name in your config file:
[theme]name = "<theme>"Supported themes are:
Custom Themes
Section titled “Custom Themes”Atuin searches for themes in ~/.atuin/themes, so you can create a new theme
by creating a file there:
[theme]name = "my-theme" # Must match the name of the file, sans .toml.
[colors]AlertInfo = "#ff0088" # Info messagesAlertWarn = "teal" # Warning messagesAlertError = "@ansi_(255)" # Error messagesAnnotation = "@rgb_(255,128,0)" # Unimportant textBase = "#ffffff" # Base foreground colorGuidance = "#00ff00" # Help messagesImportant = "#ff00ff" # Important user messagesTitle = "#ff0000" # Atuin's titleMuted = "#facade" # Muted textSyntaxCommand = "#213213" # `git` in `git status -h`SyntaxFlag = "#123123" # `-h` in `git status -h`SyntaxString = "#ababab" # `"hello"` in `echo "hello"`SyntaxVariable = "#cafeed" # `${VAR}` in `echo "${VAR}"`SyntaxOperator = "powderblue" # Operators like `||` `&&`.SyntaxComment = "#c0ffee" # Comments like `# comment`.You can use the following color formats:
| Format | Description |
|---|---|
#decade |
Hex color |
teal |
Any palette-compatible color name |
@ansi_(255) |
An ANSI color code |
@rgb_(255,128,0) |
Any RGB color |
Don’t forget to change your Atuin config to use the new theme:
[theme]name = "my-theme"When you next run Atuin, your theme should be applied.
Theme Builder
Section titled “Theme Builder”You can use this theme builder to help you build a theme.