2. Config

The most important part of your tsuki configuration is the file located at ~/.config/tsuki/config.kdl this is the file where you'll define your colorschemes and tell tsuki what goes where. After initializing tsuki, the file should look something like this.

apps {
  // add apps here
}

themes {
  // define themes here
}

commands \
  "" // define commands to run on theme change here 

Lets break it down piece by piece.

Format

The config file is written in the KDL format. You can learn more here. Its very simple, and you likely won't even need to look at the spec

Apps

This is the table where you'll define which apps you want tsuki to manage, it looks something like this when completed

apps {
  eww { // the name of the app, this corresponds to the directory name in `~/.config/tsuki/apps/`
    target "~/.config/eww" // where this apps config files should go
    templates "_colors.scss" "eww.yuck" // the file(s) we want to template, the templates should be in `~/.config/tsuki/apps/<app-name>/`
  }
  alacritty {
    target "~/.config/alacritty"
    templates "alacritty.toml"
  }
  /-foot { // a slashdash `/-` in front of an apps name disables it
    target "~/.config/foot"
    templates "foot.ini"
  }
}

Themes

This is the table where you can define template values for each theme

themes {
  horizon { // Theme name
    editor_theme "horizon-dark" // Template variables
    rofi_theme "horizon"
    wallpaper "/home/licorice/Pictures/washed-flowers.png"
    bg "101419"
    fg "DCDFE4"
    accent "F09383"
    black "1C1E26"
    magenta "EE64AC"
    green "29D398"
    yellow "FAC29A"
    blue "26BBD9"
    red "E95678"
    cyan "59E1E3"
    white "E3E6EE"
    gray "9DA0A2"
  }
  decay_light { // Another theme
    editor_theme "light-decay" // same variables, different values
    rofi_theme "light_decay"
    wallpaper "/home/licorice/Pictures/balcony_custom.jpg"
    bg "dee1e6"
    fg "101419"
    accent "417998"
    black "c5c8cd"
    magenta "8f5155"
    green "3c6843"
    yellow "a08652"
    blue "234d87"
    red "903035"
    cyan "417998"
    white "4d5768"
    gray "91c7e7"
  }
}

Commands

These are the commands to run after every theme change, many apps have commands that you can use to reload their configuration on the fly

commands \
  "eww reload" \
  "pkill -USR1 helix" \
  "makoctl reload"

Yup configuring tsuki really is that simple... Now all we need to do is set up the templates