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`

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`
* valid colors can be found in tui-rs' [Color](https://docs.rs/tui/0.12.0/tui/style/enum.Color.html) struct. 
* all customizable theme elements can be found in [`style.rs` in the `impl Default for Theme` block](https://github.com/extrawurst/gitui/blob/master/src/ui/style.rs#L305)
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			`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`
clarify further 2022-09-20 11:07:30 +03:00			`* valid colors can be found in tui-rs' [Color](https://docs.rs/tui/0.12.0/tui/style/enum.Color.html) struct.`
Add link from themes.md to referenced code block Just for convenience 2022-09-28 01:08:54 +03:00			* all customizable theme elements can be found in [`style.rs` in the `impl Default for Theme` block](https://github.com/extrawurst/gitui/blob/master/src/ui/style.rs#L305)