Customization

Create your theme

Themes are TOML files that describe the layout and styling of macchina. See Hydrogen.toml as an example.

Read the theming documentation for in-depth information on the available customization options.

Place your theme

In order for macchina to be able to find your themes, you need to place them in:

• ~/.config/macchina/themes/ on Linux and the BSDs. (or $XDG_CONFIG_HOME/macchina/themes if set)
• $HOME/.config/macchina/themes/ on macOS.
• %AppData%/macchina/themes/ on Windows.

You are not limited in the amount of themes you can create.

Use your theme

1. Run macchina --list-themes to verify that macchina has listed your theme.

2. If all goes well, you should see one or more themes listed.

3. In your macchina.toml, set theme to one of the listed themes, e.g.:

theme = "Helium" 

macchina expects theme names to be specified without a toml extension, and it considers helium and Helium for example, to be two different themes, as the option is case-sensitive.

4. You're good to go! macchina will start using your theme.