docs: organize docs

This commit is contained in:
Abhishek Keshri 2024-04-03 07:38:06 +05:30
parent 126c09279e
commit 9451d09c45
No known key found for this signature in database

131
README.md
View file

@ -36,21 +36,66 @@ tmux2k is a highly customizable framework designed to enhance your tmux status b
### 🎨 Available Themes: ### 🎨 Available Themes:
- default (`set @tmux2k-theme 'default'`) - default ![default](./images/default.png)
![default](./images/default.png) - default icons ![default-icons](./images/default-icons.png)
- default icons only (`set @tmux2k-icons-only true`) - catppuccin ![catppuccin](./images/catppuccin.png)
![default-icons](./images/default-icons.png) - catppuccin icons ![catppuccin-icons](./images/catppuccin-icons.png)
- default no powerline (`set @tmux2k-show-powerline false`) - gruvbox ![gruvbox](./images/gruvbox.png)
![default-no-powerline](./images/default-no-powerline.png) - gruvbox icons ![gruvbox-icons](./images/gruvbox-icons.png)
- catppuccin - monokai ![monokai](./images/monokai.png)
![catppuccin](./images/catppuccin.png) - monokai icons ![monokai-icons](./images/monokai-icons.png)
![catppuccin-icons](./images/catppuccin-icons.png) - onedark ![onedark](./images/onedark.png)
- gruvbox - onedark icons ![onedark-icons](./images/onedark-icons.png)
![gruvbox](./images/gruvbox.png) - duo ![duo](./images/duo.png)
![gruvbox-icons](./images/gruvbox-icons.png) - duo icons ![duo-icons](./images/duo-icons.png)
- onedark - duo blue ![duo-blue](./images/duo-blue.png)
![onedark](./images/onedark.png) - default no powerline ![default-no-powerline](./images/default-no-powerline.png)
![onedark-icons](./images/onedark-icons.png)
To use themes:
```bash
# use a theme
set -g @tmux2k-theme 'onedark'
# to show icons only
set -g @tmux2k-icons-only true
# to customize duo bg and fg
set -g @tmux2k-duo-fg "#1688f0" # this will get you duo blue shown above
set -g @tmux2k-duo-bg "#000000" # this will set the bg for duo theme
# to not show powerline glyphs
set -g @tmux2k-show-powerline false
```
#### 🖌️ Customize Theme Colors
##### Available Colors:
- `text`: Default text color. Default: `#282a36`
- `bg_main`: Background color for main sections. Default: `#15152a`
- `bg_alt`: Background color for alternate sections. Default: `#45455a`
- `black`: Black color. Default: `#0a0a0f`
- `white`: White color. Default: `#d5d5da`
- `red`: Red color. Default: `#ff001f`
- `light_red`: Light red color. Default: `#ff0055`
- `green`: Green color. Default: `#3dd50a`
- `light_green`: Light green color. Default: `#ccffcc`
- `blue`: Blue color. Default: `#1688f0`
- `light_blue`: Light blue color. Default: `#11dddd`
- `yellow`: Yellow color. Default: `#ffb86c`
- `light_yellow`: Light yellow color. Default: `#ffd21a`
- `purple`: Purple color. Default: `#bf58ff`
- `light_purple`: Light purple color. Default: `#ff65c6`
To customize theme colors:
```bash
set -g @tmux2k-text '#cdcdcd' # change text to white
set -g @tmux2k-bg-main '#ffffff' # change bg to white
set -g @tmux2k-yellow '#f8c800' # change yellow color
```
### 🧩 Available Plugins ### 🧩 Available Plugins
@ -66,7 +111,19 @@ tmux2k is a highly customizable framework designed to enhance your tmux status b
- `weather`: Show weather information - `weather`: Show weather information
- `wimdow`: tmux window list - `wimdow`: tmux window list
### 🪆 Add New Plugins To use plugins:
```bash
# set the left and right plugin sections
set -g @tmux2k-left-plugins "git cpu ram"
set -g @tmux2k-right-plugins "battery network time"
# to customize plugin colors
set -g @tmux2k-[plugin-name]-colors "[background] [foreground]"
set -g @tmux2k-cpu-colors "red black" # set cpu plugin bg to red, fg to black
```
#### 🪆 Add New Plugins
To add a new plugin, add a script to the [scripts](./scripts) folder that prints something to the console. To add a new plugin, add a script to the [scripts](./scripts) folder that prints something to the console.
@ -125,57 +182,19 @@ set -g @tmux2k-network-name "wlo1"
set -g @tmux2k-right-sep  # alternate right status bar sep set -g @tmux2k-right-sep  # alternate right status bar sep
set -g @tmux2k-win-right-sep  # alternate window right sep set -g @tmux2k-win-right-sep  # alternate window right sep
# to disable powerline
set -g @tmux2k-show-powerline false
# to customize theme
set -g @tmux2k-theme 'onedark'
# to show icons only
set -g @tmux2k-icons-only true
# to customize colors
set -g @tmux2k-text '#cdcdcd' # change text to white
set -g @tmux2k-bg-main '#ffffff' # change bg to white
set -g @tmux2k-yellow '#f8c800' # change yellow color
# to customize plugin colors
set -g @tmux2k-[plugin-name]-colors "[background] [foreground]"
set -g @tmux2k-cpu-colors "blue dark_gray"
``` ```
> You may have to restart `tmux` for some changes to reflect > You may have to restart `tmux` for some changes to reflect
### 🖌️ Customize Colors
#### Available Colors:
- `text`: Default text color. Default: `#282a36`
- `bg_main`: Background color for main sections. Default: `#15152a`
- `bg_alt`: Background color for alternate sections. Default: `#45455a`
- `black`: Black color. Default: `#0a0a0f`
- `white`: White color. Default: `#d5d5da`
- `red`: Red color. Default: `#ff001f`
- `light_red`: Light red color. Default: `#ff0055`
- `green`: Green color. Default: `#3dd50a`
- `light_green`: Light green color. Default: `#ccffcc`
- `blue`: Blue color. Default: `#1688f0`
- `light_blue`: Light blue color. Default: `#11dddd`
- `yellow`: Yellow color. Default: `#ffb86c`
- `light_yellow`: Light yellow color. Default: `#ffd21a`
- `purple`: Purple color. Default: `#bf58ff`
- `light_purple`: Light purple color. Default: `#ff65c6`
## 🏗️ What's Next ## 🏗️ What's Next
- [ ] [Windows compatibility #8](https://github.com/2KAbhishek/tmux2k/issues/8) - You tell me!
- [ ] [Theming support #9](https://github.com/2KAbhishek/tmux2k/issues/9)
## 🧑‍💻 Behind The Code ## 🧑‍💻 Behind The Code
### 🌈 Inspiration ### 🌈 Inspiration
I came across [dracula/tmux](https://github.com/dracula/tmux) sometime back but it didn't have everything I wanted. 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.
### 💡 Challenges/Learnings ### 💡 Challenges/Learnings