tmux-gruvbox/README.md
Maciej Sypień 9cb521fef1 Add basic gruvbox light theme using 256 colors
Add basic gitignore file
Add opening config files in correct vim file-types
Exclude vim file artifacts
Fix dark theme against changes in tmux v2.9
Fix typos
Improve plugin installer
Update README
Update changes to gruvbox dark theme
Update config and remove deprecated/outdated configuration
Update tmux-gruvbox-dark.conf
2020-10-29 22:18:31 +01:00

41 lines
1.5 KiB
Markdown

# Gruvbox color theme configuration for Tmux
Theme with 'retro groove' flavor for [Tmux][github-tmux], based on Pavel Pertsev's [gruvbox colorscheme][github-grovbox] and inspired by work of [Gordon Chiam](https://gist.github.com/gchiam/4606522f513cc64b79ce). Subthemes switching inspired by [tmux-color-solarized][tmux-color-solarized].
> Screenshots made from macOS builtin terminal with xterm-256color and [Hack font][github-hack].
| Dark theme | Light theme |
|---|---|
| <img src="https://i.imgur.com/STohAcp.png" title="Tmux grovbox dark colorscheme" style="width: 100%; max-width: 600px; text-align: center;" /> | <img src="https://i.imgur.com/zQZEFtU.png" title="Tmux grovbox light colorscheme" style="width: 100%; max-width: 600px; text-align: center;" /> |
## Installation
### Install manually
The simplest way is just:
> HINT: Always make a backup of your config files before any action.
```bash
cat tmux-gruvbox-dark.conf >> ~/.tmux.conf
```
### Install through [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm)
Add plugin to the list of TPM plugins in `.tmux.conf` and select desired theme
```bash
set -g @plugin 'egel/tmux-gruvbox'
set -g @tmux-gruvbox 'dark' # or 'light'
```
Hit `prefix + I` to fetch the plugin and source it. Your Tmux should be updated with the theme at this point.
## License
GPLv3 - Maciej Sypień
[github-tmux]: https://github.com/tmux/tmux
[github-grovbox]: https://github.com/morhetz/gruvbox
[github-hack]: https://github.com/chrissimpkins/Hack
[tmux-color-solarized]: https://github.com/seebi/tmux-colors-solarized