Waybar磁盘模块配置指南：实时监控系统存储空间-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00919/article/details/148441456

Waybar磁盘模块配置指南：实时监控系统存储空间

Waybar Highly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada: 项目地址: https://gitcode.com/gh_mirrors/wa/Waybar

模块概述

Waybar的磁盘模块是一个功能强大的组件，它允许用户在状态栏中实时监控系统存储空间的使用情况。这个模块特别适合需要密切关注磁盘空间的开发者和系统管理员，可以帮助用户及时发现存储空间不足的问题，避免因磁盘满载导致的系统故障。

核心配置参数详解

基本设置

路径配置(path)
- 类型：字符串
- 默认值："/"（根目录）
- 功能说明：指定要监控的文件系统路径或挂载点。你可以监控任何有效的文件系统位置，例如"/home"监控用户目录，或者"/mnt/data"监控特定数据挂载点。
轮询间隔(interval)
- 类型：整数
- 默认值：30秒
- 建议值：对于SSD可以设置较短间隔（如10秒），HDD可适当延长（如60秒）

显示格式控制

显示格式(format)
- 类型：字符串
- 默认值："{percentage_used}%"
- 高级用法：支持组合多个变量，例如："{used}/{total} ({percentage_used}%)"
单位控制(unit)
- 类型：字符串
- 可选值：kB、kiB、MB、MiB、GB、GiB、TB、TiB
- 使用场景：当需要固定显示单位而非自动调整时特别有用

交互功能

点击事件
- on-click：左键点击时执行的命令
- on-click-middle：中键点击命令
- on-click-right：右键点击命令
- 典型应用：绑定文件管理器命令，快速访问监控的磁盘
滚动事件
- on-scroll-up：向上滚动时执行
- on-scroll-down：向下滚动时执行
- 创意用法：通过滚动调整显示格式或单位

高级功能配置

状态阈值(states)

通过定义不同使用率阈值对应的显示样式，可以实现视觉警示效果。例如：

"states": {
    "warning": 80,
    "critical": 95
}

当磁盘使用率达到80%时显示警告样式，95%时显示严重警告样式。

菜单功能

菜单配置(menu)
- 类型：字符串
- 功能：定义触发菜单的动作
菜单文件(menu-file)
- 类型：字符串
- 说明：指定菜单描述文件的位置
菜单动作(menu-actions)
- 类型：数组
- 用途：定义菜单按钮对应的操作

格式变量详解

Waybar磁盘模块提供了丰富的格式化变量，满足不同显示需求：

百分比类
- {percentage_used}：已用百分比
- {percentage_free}：空闲百分比
容量类（自动单位）
- {total}：总容量
- {used}：已用容量
- {free}：可用容量
特定单位容量
- {specific_total}：指定单位的总容量
- {specific_used}：指定单位的已用容量
- {specific_free}：指定单位的可用容量
路径信息
- {path}：监控的路径

实用配置示例

基础监控配置

"disk": {
    "interval": 30,
    "path": "/home",
    "format": "Home: {percentage_free}% free",
    "tooltip-format": "{used} used out of {total} ({percentage_used}%)"
}

高级单位控制配置

"disk": {
    "interval": 60,
    "format": "{specific_used:0.1f}/{specific_total:0.1f} {unit}",
    "unit": "GB",
    "states": {
        "warning": 85,
        "critical": 95
    }
}

交互式配置示例

"disk": {
    "format": "Disk: {percentage_used}%",
    "on-click": "nautilus /",
    "on-click-right": "gnome-disks"
}

样式定制建议

磁盘模块可以通过CSS进行深度样式定制，主要选择器为#disk。建议根据使用状态设置不同样式：

#disk {
    color: #ffffff;
    background-color: #333333;
    padding: 0 10px;
}

#disk.warning {
    color: #ffcc00;
}

#disk.critical {
    color: #ff0000;
    animation: blink 1s infinite;
}