Skip to content
Atuin

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:

~/.atuin/config.toml
[theme]
name = "<theme>"

Supported themes are:

Atuin searches for themes in ~/.atuin/themes, so you can create a new theme by creating a file there:

~/.atuin/themes/my-theme.toml
[theme]
name = "my-theme" # Must match the name of the file, sans .toml.
[colors]
AlertInfo = "#ff0088" # Info messages
AlertWarn = "teal" # Warning messages
AlertError = "@ansi_(255)" # Error messages
Annotation = "@rgb_(255,128,0)" # Unimportant text
Base = "#ffffff" # Base foreground color
Guidance = "#00ff00" # Help messages
Important = "#ff00ff" # Important user messages
Title = "#ff0000" # Atuin's title
Muted = "#facade" # Muted text
SyntaxCommand = "#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:

~/.atuin/config.toml
[theme]
name = "my-theme"

When you next run Atuin, your theme should be applied.

You can use this theme builder to help you build a theme.