https://github.com/mitjafelicijan/i3blocks
Minimal i3blocks indicators
https://github.com/mitjafelicijan/i3blocks
i3 i3blocks i3wm
Last synced: 3 months ago
JSON representation
Minimal i3blocks indicators
- Host: GitHub
- URL: https://github.com/mitjafelicijan/i3blocks
- Owner: mitjafelicijan
- License: 0bsd
- Created: 2023-07-11T23:49:22.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-07-14T07:06:16.000Z (about 3 years ago)
- Last Synced: 2025-12-27T02:53:57.440Z (7 months ago)
- Topics: i3, i3blocks, i3wm
- Language: C
- Homepage:
- Size: 34.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# i3blocks and some custom scripts
- CPU usage progress bar (requires: mpstat, grep, awk)
- Memory usage progress bar (requires: free, grep, awk)
- Disk usage progress bar (requires: df, awk, sed)
- Nvidia GPU usage progress bar (requires: nvidia-smi)
> **Note**: If default width of 10 is used and used percentage for a resource is
> bellow 10% then no bars will be displayed! The bigger the width is the more
> accurate the progress bar will be.
## Install and use
- C compiler like GCC, Clang or tcc is required.
Clone the repository into `~/.config/i3blocks`.
```bash
git clone git@github.com:mitjafelicijan/i3blocks.git ~/.config/i3blocks
cd ~/.config/i3blocks
make
# Before doing this check config_sample and be sure
# you don't overwrite your existing config file.
cp config_sample config
```
And restart i3 with `$mod+shift+r`. That is about it.
### Available options
Each command takes two **optional** arguments:
- `-w 10` - width of the progress bar (default 10)
- `-p 1` - if 1 then it also prints percentage label (default 0)
Example usage of these arguments:
```bash
./cpu # will display 10 bars and no percentage label
./cpu -w 20 # will display 20 bars and no percentage label
./cpu -w 20 -p 0 # will display 20 bars and no percentage label
./cpu -w 10 -p 1 # will display 10 bars and percentage label
```
I use default fonts for i3 and if you will change to something different your
progress could look better. I just don't care that much about that and it's fine
with me.
### Colors
You can also use custom colors for blocks by providing `color` in config file.
```ini
[cpu]
label=CPU
color=#00FF00
command=~/.config/i3blocks/cpu -w 10
separator=true
interval=3
```
## Similar blocks
Check https://github.com/vivien/i3blocks-contrib for amazing blocks!
## License
[i3blocks](https://github.com/mitjafelicijan/i3blocks) was written by [Mitja
Felicijan](https://mitjafelicijan.com) and is released under the BSD zero-clause
license, see the LICENSE file for more information.