@@ -36,76 +36,103 @@ tmux2k is a highly customizable framework designed to enhance your tmux status b
3636
3737### π¨ Available Themes:
3838
39- - default (` set @tmux2k-theme 'default' ` )
40- ![ default] ( ./images/default.png )
41- - default icons only (` set @tmux2k-icons-only true ` )
42- ![ default-icons] ( ./images/default-icons.png )
43- - default no powerline (` set @tmux2k-show-powerline false ` )
44- ![ default-no-powerline] ( ./images/default-no-powerline.png )
45- - catppuccin
46- ![ catppuccin] ( ./images/catppuccin.png )
47- ![ catppuccin-icons] ( ./images/catppuccin-icons.png )
48- - gruvbox
49- ![ gruvbox] ( ./images/gruvbox.png )
50- ![ gruvbox-icons] ( ./images/gruvbox-icons.png )
51- - onedark
52- ![ onedark] ( ./images/onedark.png )
53- ![ onedark-icons] ( ./images/onedark-icons.png )
39+ - default ![ default] ( ./images/default.png )
40+ - default icons ![ default-icons] ( ./images/default-icons.png )
41+ - catppuccin ![ catppuccin] ( ./images/catppuccin.png )
42+ - catppuccin icons ![ catppuccin-icons] ( ./images/catppuccin-icons.png )
43+ - gruvbox ![ gruvbox] ( ./images/gruvbox.png )
44+ - gruvbox icons ![ gruvbox-icons] ( ./images/gruvbox-icons.png )
45+ - monokai ![ monokai] ( ./images/monokai.png )
46+ - monokai icons ![ monokai-icons] ( ./images/monokai-icons.png )
47+ - onedark ![ onedark] ( ./images/onedark.png )
48+ - onedark icons ![ onedark-icons] ( ./images/onedark-icons.png )
49+ - duo ![ duo] ( ./images/duo.png )
50+ - duo icons ![ duo-icons] ( ./images/duo-icons.png )
51+ - duo blue ![ duo-blue] ( ./images/duo-blue.png )
52+ - default no powerline ![ default-no-powerline] ( ./images/default-no-powerline.png )
53+
54+ To use themes:
5455
55- ### π§© Available Plugins
56-
57- - ` battery ` : Show battery stats and percentage
58- - ` git ` : Show Git branch and status information
59- - ` cpu ` : Show CPU usage information
60- - ` gpu ` : Show GPU usage information
61- - ` ram ` : Show RAM usage information
62- - ` network ` : Show network status and statistics
63- - ` bandwidth ` : Show network bandwidth usage
64- - ` ping ` : Show network ping statistics
65- - ` time ` : Show current time and date
66- - ` weather ` : Show weather information
67- - ` wimdow ` : tmux window list
56+ ``` bash
57+ # use a theme
58+ set -g @tmux2k-theme ' onedark'
6859
69- ### πͺ Add New Plugins
60+ # to show icons only
61+ set -g @tmux2k-icons-only true
7062
71- To add a new plugin, add a script to the [ scripts] ( ./scripts ) folder that prints something to the console.
63+ # to customize duo bg and fg
64+ set -g @tmux2k-duo-fg " #1688f0" # this will get you duo blue shown above
65+ set -g @tmux2k-duo-bg " #000000" # this will set the bg for duo theme
7266
73- > The plugin name and script file name must match e.g: plugin named ` foo ` should have a file called ` scripts/foo.sh `
67+ # to set powerline symbols
68+ set -g @tmux2k-right-sep ξ΄ # alternate right status bar sep
69+ set -g @tmux2k-win-right-sep ξ² # alternate window right sep
7470
75- ## β‘ Setup
71+ # to not show powerline
72+ set -g @tmux2k-show-powerline false
7673
77- ### βοΈ Requirements
74+ # set start icon, accpets: `session`, 'window`, or any string
75+ set -g @tmux2k-start-icon " ξ―"
76+ ```
7877
79- Before you begin, ensure you have met the following requirements:
78+ #### ποΈ Customize Theme Colors
8079
81- - You have installed the latest version of ` tmux ` .
82- - bash 5.2 or newer, mac users can install it using ` brew install bash `
83- - [ tpm] ( https://github.com/tmux-plugins/tpm ) for managing ` tmux ` plugins.
84- - A [ patched nerd font] ( https://www.nerdfonts.com/ ) for ` powerline ` and glyphs support.
80+ ##### Available Colors:
8581
86- ### π» Installation
82+ - ` text ` : Default text color. Default: ` #282a36 `
83+ - ` bg_main ` : Background color for main sections. Default: ` #15152a `
84+ - ` bg_alt ` : Background color for alternate sections. Default: ` #45455a `
85+ - ` black ` : Black color. Default: ` #0a0a0f `
86+ - ` white ` : White color. Default: ` #d5d5da `
87+ - ` red ` : Red color. Default: ` #ff001f `
88+ - ` light_red ` : Light red color. Default: ` #ff0055 `
89+ - ` green ` : Green color. Default: ` #3dd50a `
90+ - ` light_green ` : Light green color. Default: ` #ccffcc `
91+ - ` blue ` : Blue color. Default: ` #1688f0 `
92+ - ` light_blue ` : Light blue color. Default: ` #11dddd `
93+ - ` yellow ` : Yellow color. Default: ` #ffb86c `
94+ - ` light_yellow ` : Light yellow color. Default: ` #ffd21a `
95+ - ` purple ` : Purple color. Default: ` #bf58ff `
96+ - ` light_purple ` : Light purple color. Default: ` #ff65c6 `
8797
88- If you are a ` tpm ` user, you can install the theme and keep up to date by adding the following to your ` .tmux.conf ` file :
98+ To customize theme colors :
8999
90100``` bash
91- set -g @plugin ' 2kabhishek/tmux2k'
92-
101+ set -g @tmux2k-text ' #cdcdcd' # change text to white
102+ set -g @tmux2k-bg-main ' #ffffff' # change bg to white
103+ set -g @tmux2k-yellow ' #f8c800' # change yellow color
93104```
94105
95- - Run ` tmux `
96- - Use the ` tpm ` install command: prefix + I (default prefix is ` ctrl+b ` )
106+ > You may have to restart ` tmux ` for some changes to reflect
97107
98- You can also directly clone the repo to your ` ~/.tmux/plugins/ ` folder.
108+ ### π§© Available Plugins
99109
100- ## π Usage
110+ - ` battery ` : Show battery stats and percentage
111+ - ` git ` : Show Git branch and status information
112+ - ` cpu ` : Show CPU usage information
113+ - ` gpu ` : Show GPU usage information
114+ - ` ram ` : Show RAM usage information
115+ - ` network ` : Show network status and statistics
116+ - ` bandwidth ` : Show network bandwidth usage
117+ - ` ping ` : Show network ping statistics
118+ - ` time ` : Show current time and date
119+ - ` weather ` : Show weather information
120+ - ` wimdow ` : tmux window list
101121
102- tmux2k to should automatically start after installation. Here's how you can customize it's features
122+ To use plugins:
103123
104124``` bash
105- # Left and right status bar plugins
125+ # set the left and right plugin sections
106126set -g @tmux2k-left-plugins " git cpu ram"
107127set -g @tmux2k-right-plugins " battery network time"
108128
129+ # to customize plugin colors
130+ set -g @tmux2k-[plugin-name]-colors " [background] [foreground]"
131+ set -g @tmux2k-cpu-colors " red black" # set cpu plugin bg to red, fg to black
132+
133+ # to enable compact window list size
134+ set -g @tmux2k-compact-windows true
135+
109136# change refresh rate
110137set -g @tmux2k-refresh-rate 5
111138
@@ -115,70 +142,50 @@ set -g @tmux2k-show-fahrenheit false
115142# 24 hour time
116143set -g @tmux2k-military-time true
117144
118- # it can accept `session`, 'window`, or any string
119- set -g @tmux2k-start-icon " ξ―"
120-
121145# network interface to watch
122146set -g @tmux2k-network-name " wlo1"
147+ ```
123148
124- # update powerline symbols
125- set -g @tmux2k-right-sep ξ΄ # alternate right status bar sep
126- set -g @tmux2k-win-right-sep ξ² # alternate window right sep
149+ #### πͺ Add New Plugins
127150
128- # to disable powerline
129- set -g @tmux2k-show-powerline false
151+ To add a new plugin, add a script to the [ scripts] ( ./scripts ) folder that prints something to the console.
130152
131- # to customize theme
132- set -g @tmux2k-theme ' onedark'
153+ > The plugin name and script file name must match e.g: plugin named ` foo ` should have a file called ` scripts/foo.sh `
133154
134- # to show icons only
135- set -g @tmux2k-icons-only true
155+ ## β‘ Setup
136156
137- # to enable compact window tab size
138- set -g @tmux2k-compact-windows true
157+ ### βοΈ Requirements
139158
140- # to customize colors
141- set -g @tmux2k-text ' #cdcdcd' # change text to white
142- set -g @tmux2k-bg-main ' #ffffff' # change bg to white
143- set -g @tmux2k-yellow ' #f8c800' # change yellow color
159+ Before you begin, ensure you have met the following requirements:
144160
145- # to customize plugin colors
146- set -g @tmux2k-[plugin-name]-colors " [background] [foreground] "
147- set -g @tmux2k-cpu-colors " blue dark_gray "
148- ```
161+ - You have installed the latest version of ` tmux ` .
162+ - bash 5.2 or newer, mac users can install it using ` brew install bash `
163+ - [ tpm ] ( https://github.com/tmux-plugins/tpm ) for managing ` tmux ` plugins.
164+ - A [ patched nerd font ] ( https://www.nerdfonts.com/ ) for ` powerline ` and glyphs support.
149165
150- > You may have to restart ` tmux ` for some changes to reflect
166+ ### π» Installation
151167
152- ### ποΈ Customize Colors
168+ If you are a ` tpm ` user, you can install the theme and keep up to date by adding the following to your ` .tmux.conf ` file:
153169
154- #### Available Colors:
170+ ``` bash
171+ set -g @plugin ' 2kabhishek/tmux2k'
155172
156- - ` text ` : Default text color. Default: ` #282a36 `
157- - ` bg_main ` : Background color for main sections. Default: ` #15152a `
158- - ` bg_alt ` : Background color for alternate sections. Default: ` #45455a `
159- - ` black ` : Black color. Default: ` #0a0a0f `
160- - ` white ` : White color. Default: ` #d5d5da `
161- - ` red ` : Red color. Default: ` #ff001f `
162- - ` light_red ` : Light red color. Default: ` #ff0055 `
163- - ` green ` : Green color. Default: ` #3dd50a `
164- - ` light_green ` : Light green color. Default: ` #ccffcc `
165- - ` blue ` : Blue color. Default: ` #1688f0 `
166- - ` light_blue ` : Light blue color. Default: ` #11dddd `
167- - ` yellow ` : Yellow color. Default: ` #ffb86c `
168- - ` light_yellow ` : Light yellow color. Default: ` #ffd21a `
169- - ` purple ` : Purple color. Default: ` #bf58ff `
170- - ` light_purple ` : Light purple color. Default: ` #ff65c6 `
173+ ```
174+
175+ - Run ` tmux `
176+ - Use the ` tpm ` install command: prefix + I (default prefix is ` ctrl+b ` )
177+
178+ You can also directly clone the repo to your ` ~/.tmux/plugins/ ` folder.
171179
172180## ποΈ What's Next
173181
174- - [ ] [ Windows compatibility #8 ] ( https://github.com/2KAbhishek/tmux2k/issues/8 )
175- - [ ] [ Theming support #9 ] ( https://github.com/2KAbhishek/tmux2k/issues/9 )
182+ - You tell me!
176183
177184## π§βπ» Behind The Code
178185
179186### π Inspiration
180187
181- I came across [ dracula/tmux] ( https://github.com/dracula/tmux ) sometime back but it didn't have everything I wanted .
188+ I came across [ dracula/tmux] ( https://github.com/dracula/tmux ) sometime back and I wanted to create a more customizable and easy to expand solution .
182189
183190### π‘ Challenges/Learnings
184191
0 commit comments