yambar-modules-disk-io - Man Page
This module keeps track of the amount of bytes being read/written from/to disk. It can distinguish between all partitions currently present in the machine.
Tags
| Name | Type | Description | |||
| device | string | Name of the device being tracked (use the command lsblk to see these). There is a special device, "Total", that reports the total stats for the machine | |||
| is_disk | boolean | whether or not the device is a disk (e.g. sda, sdb) or a partition (e.g. sda1, sda2, ...). "Total" is advertised as a disk. | |||
| read_speed | int | bytes read, in bytes/s | |||
| write_speed | int | bytes written, in bytes/s | |||
| ios_in_progress | int | number of ios that are happening at the time of polling |
Configuration
| Name | Type | Req | Description | |||
| poll-interval | int | no | Refresh interval of disk's stats in milliseconds (default=500). Cannot be less then 250ms. |
Examples
This reports the total amount of bytes being read and written every second, formatting in b/s, kb/s, mb/s, or gb/s, as appropriate.
bar:
left:
- disk-io:
poll-interval: 1000
content:
map:
conditions:
device == Total:
list:
items:
- string: {text: "Total read: "}
- map:
default: {string: {text: "{read_speed} B/s"}}
conditions:
read_speed > 1073741824:
string: {text: "{read_speed:gib} GB/s"}
read_speed > 1048576:
string: {text: "{read_speed:mib} MB/s"}
read_speed > 1024:
string: {text: "{read_speed:kib} KB/s"}
- string: {text: " | "}
- string: {text: "Total written: "}
- map:
default: {string: {text: "{write_speed} B/s"}}
conditions:
write_speed > 1073741824:
string: {text: "{write_speed:gib} GB/s"}
write_speed > 1048576:
string: {text: "{write_speed:mib} MB/s"}
write_speed > 1024:
string: {text: "{write_speed:kib} KB/s"}See Also
yambar-modules(5), yambar-particles(5), yambar-tags(5), yambar-decorations(5)
Referenced By
2025-07-25