gitui/THEMES.md

# Themes

default on light terminal:
![](assets/light-theme.png)

to change the colors of the default theme you have to modify `theme.ron` file
[Ron format](https://github.com/ron-rs/ron) located at config path. The path differs depending on the operating system:

* `$HOME/.config/gitui/theme.ron` (mac)
* `$XDG_CONFIG_HOME/gitui/theme.ron` (linux using XDG)
* `$HOME/.config/gitui/theme.ron` (linux)
* `%APPDATA%/gitui/theme.ron` (Windows)

Alternatively you may make a theme in the same directory mentioned above with and select with the `-t` flag followed by the name of the file in the directory. E.g. If you are on linux calling `gitui -t arc.ron` wil use `$XDG_CONFIG_HOME/gitui/arc.ron` or `$HOME/.config/gitui/arc.ron`

Valid colors can be found in tui-rs' [Color](https://docs.rs/tui/0.12.0/tui/style/enum.Color.html) struct. 

Notes:

* rgb colors might not be supported in every terminal. 
* using a color like `yellow` might appear in whatever your terminal/theme defines for `yellow`
Remove ui::style::ColorDef in favor up tui::style::Color (#391) Closes #149. 2020-10-31 14:26:30 +03:00			`# Themes`
polish readme/changelog 2020-05-20 13:00:17 +03:00
			`default on light terminal:`
			`![](assets/light-theme.png)`

Allow user to set theme with flag (#481) closes #480 2021-01-28 00:24:27 +03:00			to change the colors of the default theme you have to modify `theme.ron` file
Move config directory This changes the config directory from the `dirs::cache_dir` to `dirs::config_dir`. It does however keep the cache directory as the default logging directory, as it seems a better fit. It also adds a function, `migrate_config`, which is called at startup to move directory entries inside the "old" config directory to the "new" one (but it skips moving log files). The intention is that this function can be removed after a few releases when the likelihood of someone upgrading from 0.6.0 or earlier is fairly small. Fixes #98 2020-06-15 01:09:02 +03:00			`[Ron format](https://github.com/ron-rs/ron) located at config path. The path differs depending on the operating system:`

Fix the path of the theme file on mac (#819) 2021-07-17 11:31:20 +03:00			* `$HOME/.config/gitui/theme.ron` (mac)
Move config directory This changes the config directory from the `dirs::cache_dir` to `dirs::config_dir`. It does however keep the cache directory as the default logging directory, as it seems a better fit. It also adds a function, `migrate_config`, which is called at startup to move directory entries inside the "old" config directory to the "new" one (but it skips moving log files). The intention is that this function can be removed after a few releases when the likelihood of someone upgrading from 0.6.0 or earlier is fairly small. Fixes #98 2020-06-15 01:09:02 +03:00			* `$XDG_CONFIG_HOME/gitui/theme.ron` (linux using XDG)
			* `$HOME/.config/gitui/theme.ron` (linux)
Update themes doc with Windows path 2021-05-05 20:19:14 +03:00			* `%APPDATA%/gitui/theme.ron` (Windows)
polish readme/changelog 2020-05-20 13:00:17 +03:00
Allow user to set theme with flag (#481) closes #480 2021-01-28 00:24:27 +03:00			Alternatively you may make a theme in the same directory mentioned above with and select with the `-t` flag followed by the name of the file in the directory. E.g. If you are on linux calling `gitui -t arc.ron` wil use `$XDG_CONFIG_HOME/gitui/arc.ron` or `$HOME/.config/gitui/arc.ron`

clarify colors being defined by your terminal 2021-12-09 23:53:59 +03:00			`Valid colors can be found in tui-rs' [Color](https://docs.rs/tui/0.12.0/tui/style/enum.Color.html) struct.`

			`Notes:`

			`* rgb colors might not be supported in every terminal.`
			* using a color like `yellow` might appear in whatever your terminal/theme defines for `yellow`