Skip to content

Customization

Jump to bottom
Aziz Ben Ali edited this page Dec 31, 2021 · 12 revisions

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:

  • $XDG_CONFIG_HOME/macchina/themes on Linux and the BSDs.
  • $HOME/.config/macchina/themes on macOS.
  • %AppData%/macchina/themes on Windows.

Use your theme

To start using 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" # case-sensitive >:)
  1. You're good to go! macchina will start using your theme.
Clone this wiki locally