aboutsummaryrefslogtreecommitdiff
path: root/README.rst
blob: c3e8b4553ca6c30abd884b80b6d51e8129e90a88 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
Tmux ColorTag Theme
-------------------

.. raw:: html

    <div align="center">
    <img src="https://raw.githubusercontent.com/Determinant/tmux-colortag/master/demo.gif" width="95%">
    </div>

Also...works for powerline haters...

.. image:: https://raw.githubusercontent.com/Determinant/tmux-colortag/master/no-powerline-symbol.png

What's This?
============

This is a very succinct theme that colors the window tags according to their
names. This means with a proper ``status-interval`` set in your tmux (see
below), it can even automatically change when various programs in your shell
runs!

Installation
============

- If you don't have powerline symbols in your terminal font (or you don't know
  what that is), add the following line to the top of your ``.tmux.conf``:

  ::

    TMUX_COLORTAG_NOPOWERLINE=yes

- Make sure you have tmux plugin manager installed: https://github.com/tmux-plugins/tpm

- Add plugin to the list of TPM plugins in ``.tmux.conf``:

  ::
    
    set -g @plugin 'Determinant/tmux-colortag'

- Hit ``prefix`` + ``I`` to fetch the plugin and source it.

- Optional:

  - To immediately play with the main feature, try ``prefix`` (``Ctrl+b`` by default) + ``,`` and change the window name.
  - NOTE: tmux won't change the window name automatically once you set it manually. To test the auto-changing color, just run any command in your new window.

- Optional: for the best experience, this plugin assumes a short status update
  interval. To change it back, specify ``TMUX_COLORTAG_SET_INTERVAL=no`` or
  directly override the setting in your tmux config file.

- Optional: if you don't like powerline symbols, feel free to change them by
  specifying the following environment variables to override the default:

  - ``TMUX_ARROW_SYMBOL_L1``
  - ``TMUX_ARROW_SYMBOL_L2``
  - ``TMUX_ARROW_SYMBOL_R1``
  - ``TMUX_ARROW_SYMBOL_R2``