update README to cover themes

This commit is contained in:
Mitchell Hashimoto
2023-11-22 22:25:47 -08:00
parent 5acaf3279d
commit dead82bcf1

View File

@ -129,6 +129,33 @@ if something isn't working.
Eventually, we'll have a better mechanism for showing errors to the user. Eventually, we'll have a better mechanism for showing errors to the user.
### Themes
Ghostty ships with 300+ built-in themes (from
[iTerm2 Color Schemes](https://github.com/mbadolato/iTerm2-Color-Schemes)).
You can configure Ghostty to use any of these themes using the `theme`
configuration. Example:
```
theme = Solarized Dark - Patched
```
You can find a list of built-in themes using the `+list-themes` action:
```
$ ghostty +list-themes
...
```
On macOS, the themes are built-in to the `Ghostty.app` bundle. On Linux,
theme support requires a valid Ghostty resources dir ("share" directory).
More details about how to validate the resources directory on Linux
is covered in the [shell integration section](#shell-integration-installation-and-verification).
Any custom color configuration (`palette`, `background`, `foreground`, etc.)
in your configuration files will override the theme settings. This can be
used to load a theme and fine-tune specific colors to your liking.
### Shell Integration ### Shell Integration
Ghostty supports some features that require shell integration. I am aiming Ghostty supports some features that require shell integration. I am aiming