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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
Tmux ColorTag Plugin/Theme
--------------------------
.. raw:: html
<div align="center">
<img src="https://raw.githubusercontent.com/Determinant/tmux-colortag/master/demo.gif" width="90%">
</div>
Also works for powerline haters with default setting.
.. raw:: html
<div align="center">
<img src="https://raw.githubusercontent.com/Determinant/tmux-colortag/master/no-powerline-symbol.png" width="70%">
</div>
What's This?
============
This is a very succinct plugin that colors the window tags according to their
names. The color can even automatically change when your shell runs different
programs! It also serves as a minimal theme that is friendly to any people who
just want something simple and works.
Features
========
- Automically color the window tabs by their name hash
- Manual control of coloring in tmux (also saved)
- Support Powerline symbols
TLDR; I just want it
====================
- Execute the following line in your shell:
::
curl -sS https://raw.githubusercontent.com/Determinant/tmux-colortag/master/bootstrap.sh | bash
- Run ``tmux``, and then hit ``Ctrl+b``, release, then ``I`` so everything should be ready.
Installation
============
- Make sure you have tmux plugin manager installed: https://github.com/tmux-plugins/tpm
- Add it 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.
Help
====
Press ``prefix``, then ``C``, type ``help`` and press enter.
Customization
=============
- To manually set the color of the active window tag, press ``prefix`` + ``C`` and:
- ``color-idx <0-255 color code>`` to manually set the color for the window index
- ``color-name <0-255 color code>`` to manually set the color for the name
- ``clear-idx`` clears the preivous color of the index
- ``clear-name`` clears the preivous color of the name
- ``clear-all`` use auto-coloring for all window tags
.. raw:: html
<div align="center">
<img src="https://raw.githubusercontent.com/Determinant/tmux-colortag/master/demo-manual-coloring.gif" width="90%">
</div>
- If you would like to use Powerline symbols like shown in the demo, add the
following line to the top of your ``.tmux.conf`` to enable them:
::
TMUX_COLORTAG_USE_POWERLINE=yes
# uncomment the following line to have rounded arrows
# TMUX_COLORTAG_ROUNDED_POWERLINE=yes
- To change the prompt key (``prefix`` + ``C``), specify your key in ``TMUX_COLORTAG_KEY``.
- TIP: If you love the status bar on the top (instead of at the bottom by default in tmux), add ``set-option -g status-position top`` to your config file
- Other tweakable variables:
- ``TMUX_COLORTAG_TAG_BOLD``: specify ``yes`` if you want bold tag text
- ``TMUX_COLORTAG_TAG_FOCUS_UNDERLINE``: specify ``yes`` if you want underlined text for the active tag
- ``TMUX_COLORTAG_TAG_TEXT_COLOR``
- ``TMUX_COLORTAG_TAG_FOCUS_TEXT_COLOR``
- ``TMUX_ARROW_SYMBOL_L1``
- ``TMUX_ARROW_SYMBOL_L2``
- ``TMUX_ARROW_SYMBOL_R1``
- ``TMUX_ARROW_SYMBOL_R2``
- ``TMUX_COLORTAG_SET_INTERVAL``: for the best experience, this plugin
assumes a short status update interval. To change it back, make it ``no`` or
directly override the setting in your tmux config file.
- ``TMUX_COLORTAG_TAG_ONLY``: if you only want to color the tags (without
changing other styles such as borders), make it ``yes``.
- ``TMUX_COLORTAG_IDX_SEP``: controls the separator between the window index and name.
- ``TMUX_COLORTAG_SEP_LEFT_PADDING``: padding string before the separator
- ``TMUX_COLORTAG_SEP_RIGHT_PADDING``: padding string after the separator
- Theme colors (value example: "colour123")
- ``colortag_bg0``
- ``colortag_bg1``
- ``colortag_white0``: font color of the active tag
- ``colortag_white1``: color of the active pane border
- ``colortag_lightgray``
- ``colortag_darkgray``
Update to the Latest Version
============================
- Hit ``prefix`` + ``U`` and choose this plugin.
|