summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9ff0682
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Gruvbox colorscheme for tmux
+
+Retro groove colorscheme for [tmux](https://github.com/tmux/tmux), based on the excellent [gruvbox](https://github.com/morhetz/gruvbox) theme for Vim.
+
+This is a heavily modified fork of [tmux-gruvbox](https://github.com/egel/tmux-gruvbox).
+
+Features/Differences:
+- Uses gruvbox's hexadecimal colors (most terminal emulators have truecolor support)
+- Indicates when the prefix key has been pressed
+- If vi-mode is enabled (if `$EDITOR` contains `vim`), the statusbar will indicate its mode while being edited
+- Highlights unfocused windows with activity or terminal bells
+- Does not use custom glyphs
+
+## Installation
+### Manual
+Just clone this repo and add `tmux-colorscheme.conf` to your `.tmux.conf`:
+```bash
+cat tmux-colorscheme.conf >> ~/.tmux.conf
+```
+### Tmux Plugin Manager
+Add this repo to the list of [TPM](https://github.com/tmux-plugins/tpm) plugins in your `.tmux.conf`:
+```tmux
+set -g @plugin 'lawabidingcactus/tmux-gruvbox-truecolor'
+```
+Press `<prefix> + I` to reload tmux with the plugin.