Skip to content

Commit 85a7cca

Browse files
authored
Merge pull request #14 from 2KAbhishek/more-themes
Add more themes
2 parents 54f87ee + 05d62b0 commit 85a7cca

16 files changed

+141
-98
lines changed

β€ŽREADME.mdβ€Ž

Lines changed: 98 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -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
106126
set -g @tmux2k-left-plugins "git cpu ram"
107127
set -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
110137
set -g @tmux2k-refresh-rate 5
111138

@@ -115,70 +142,50 @@ set -g @tmux2k-show-fahrenheit false
115142
# 24 hour time
116143
set -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
122146
set -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

β€Žimages/catppuccin.pngβ€Ž

-1.01 KB
Loading

β€Žimages/catpuccin-icons.pngβ€Ž

56.5 KB
Loading

β€Žimages/default-icons.pngβ€Ž

1.74 KB
Loading
-407 Bytes
Loading

β€Žimages/default.pngβ€Ž

-2.63 KB
Loading

β€Žimages/duo-blue.pngβ€Ž

55.4 KB
Loading

β€Žimages/duo-icons.pngβ€Ž

45.3 KB
Loading

β€Žimages/duo.pngβ€Ž

51.1 KB
Loading

β€Žimages/gruvbox-icons.pngβ€Ž

-1.17 KB
Loading

0 commit comments

Comments
Β (0)