skip to content
github5 stars, opens in a new tab

docscreating palettes

Tune a palette

You can change any palette's colors, an official one included, without making a copy. Your tuning is kept apart from the palette: just the colors you moved, laid over the colors its marketplace gives.

on this page
  1. Open the editor
  2. What tuning does
  3. Fix the contrast in one step
  4. Go back
  5. Share a tuned palette

Open the editor

ttheme edit miku  # a palette that is not yours: your changes are kept as its tuning
ttheme edit  # asks to edit the palette this tab shows

In ttheme, the same editor opens from a palette's panel: put the cursor on the palette, press tab, then enter on Edit palette.

The editor works as it does for your own palette: pick a color, tune it, and s saves. Tuning has no seeds or signature marks, and it never changes the palette file itself.

What tuning does

  • Every terminal you wired, the shell and the pictures' tint follow your tuning at once, in every open tab that shows the palette.
  • ttheme update leaves it in place. A new version of the palette shows through every color you did not tune.
  • Tuning belongs to one mode, so light and dark can be tuned apart.
  • Preview and Browse mark a tuned palette with a yellow ●.

Your tuning lives in ~/.config/ttheme/tone.json.

Fix the contrast in one step

ttheme check miku  # every contrast check's numbers for a palette
ttheme check --fix miku  # colors that pass, saved as its tuning

On a palette of your own, --fix writes the colors into its file instead.

Go back

In the editor, R puts every color back to the marketplace's colors, and s after it drops your tuning. In the panel, Reset palette beside Edit palette does the same: enter, then enter again to confirm.

Share a tuned palette

ttheme share miku asks whether to share your tuning or the original. A tuned palette goes out as miku-tuned, since miku belongs to the original wherever it is installed. Share a link covers the rest.