waybar-disk(5) File Formats Manual waybar-disk(5)

waybar-disk - ماژول فضای دیسک در waybar

ماژول disk میزان فضای مصرف‌شده دیسک را در حال حاضر نمایش می‌دهد.

با نام disk آدرس‌دهی می‌شود.

path:
نوع: رشته (string)
پیش‌فرض: "/"
هر مسیری درون فایل‌سیستم یا نقطه اتصالی (mountpoint) که اطلاعات آن باید نمایش داده شود.

interval:
نوع: عدد صحیح (integer)
پیش‌فرض: 30
بازه زمانی دریافت دوره‌ای اطلاعات (بر حسب ثانیه).

format:
نوع: رشته (string)
پیش‌فرض: "{percentage_used}%"
قالب نحوه نمایش اطلاعات.

rotate:
نوع: عدد صحیح (integer)
مقدار مثبت جهت چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).

states:
نوع: شیء (object)
تعدادی از وضعیت‌های مصرف دیسک که بر اساس آستانه‌های درصدی مشخص (percentage_used) فعال می‌شوند. ببینید waybar-states(5).

max-length:
نوع: عدد صحیح (integer)
حداکثر طول برچسب بر حسب کاراکتر که ماژول باید نمایش دهد.

min-length:
نوع: عدد صحیح (integer)
حداقل طول برچسب بر حسب کاراکتر که ماژول باید بپذیرد.

align:
نوع: ممیز شناور (float)
تراز برچسب در داخل ماژول، که در آن 0 چپ‌چین و 1 راست‌چین است. اگر ماژول چرخانده شود، از جریان متن پیروی می‌کند.

justify:
نوع: رشته (string)
تراز متن درون برچسب ماژول، که گزینه‌های 'left' (چپ)، 'right' (راست) یا 'center' (وسط) را جهت تعیین موقعیت می‌پذیرد.

on-click:
نوع: رشته (string)
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.

on-click-middle:
نوع: رشته (string)
دستوری که هنگام کلیک وسط (با چرخ ماوس) روی ماژول اجرا می‌شود.

on-click-right:
نوع: رشته (string)
دستوری که هنگام کلیک راست روی ماژول اجرا می‌شود.

on-update:
نوع: رشته (string)
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.

on-scroll-up:
نوع: رشته (string)
دستوری که هنگام پیمایش به بالا (اسکرول) روی ماژول اجرا می‌شود.

on-scroll-down:
نوع: رشته (string)
دستوری که هنگام پیمایش به پایین روی ماژول اجرا می‌شود.

smooth-scrolling-threshold:
نوع: اعشاری (double)
آستانه مورد استفاده هنگام پیمایش روان.

tooltip:
نوع: بولی (bool)
پیش‌فرض: true
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام قرار گرفتن نشانگر ماوس روی ماژول.

tooltip-format:
نوع: رشته (string)
پیش‌فرض: "{used} out of {total} used ({percentage_used}%)"
قالب اطلاعات نمایش‌داده‌شده در راهنمای شناور.

unit:
نوع: رشته (string)
همراه با specific_free ،specific_used و specific_total استفاده می‌شود تا محاسبات را همواره در یک واحد مشخص مقید کند. واحدهای kB ،kiB ،MB ،Mib ،GB ،GiB ،TB و TiB را می‌پذیرد.

menu:
نوع: رشته (string)
عملیاتی که منو را باز می‌کند.

menu-file:
نوع: رشته (string)
محل فایل توصیف‌کننده منو. باید عنصری از نوع

GtkMenu با شناسه menu وجود داشته باشد.

menu-actions:
نوع: آرایه (array)
عملیات متناظر با دکمه‌های منو.

expand:
نوع: بولی (bool)
پیش‌فرض: false
به این ماژول اجازه می‌دهد تمام فضای باقی‌مانده را به صورت پویا اشغال کند.

{percentage_used}: درصد فضای دیسک در حال استفاده.

{percentage_free}: درصد فضای آزاد دیسک.

{total}: مقدار کل فضای دیسک، پارتیشن یا نقطه اتصال. واحد را به‌طور خودکار بر اساس اندازه باقی‌مانده انتخاب می‌کند.

{used}: مقدار فضای استفاده‌شده دیسک. واحد را به‌طور خودکار بر اساس اندازه باقی‌مانده انتخاب می‌کند.

{free}: مقدار فضای آزاد دیسک برای کاربران عادی. واحد را به‌طور خودکار بر اساس اندازه باقی‌مانده انتخاب می‌کند.

{path}: مسیر مشخص‌شده در پیکربندی.

{specific_total}: مقدار کل فضای دیسک، پارتیشن یا نقطه اتصال در یک واحد مشخص. پیش‌فرض بر حسب بایت است.

{specific_used}: مقدار فضای استفاده‌شده دیسک در یک واحد مشخص. پیش‌فرض بر حسب بایت است.

{specific_free}: مقدار فضای آزاد دیسک برای کاربران عادی در یک واحد مشخص. پیش‌فرض بر حسب بایت است.

"disk": {
	"interval": 30,
	"format": "{percentage_free}% free on {path}",
}
"disk": {
	"interval": 30,
	"format": "{specific_free:0.2f} GB out of {specific_total:0.2f} GB available. Alternatively {free} out of {total} available",
	"unit": "GB"
	// 1434.25 GB out of 2000.00 GB available. Alternatively 1.4TiB out of 1.9TiB available.
}

•
#disk
2026-08-31