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

نام (NAME)
       waybar-disk - ماژول فضای دیسک در waybar

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

پیکربندی (CONFIGURATION)
       با نام 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
       به این ماژول اجازه می‌دهد تمام فضای باقی‌مانده را به صورت پویا اشغال کند.

جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)
       {percentage_used}: درصد فضای دیسک در حال استفاده.

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

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

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

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

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

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

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

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

مثال‌ها (EXAMPLES)
           "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.
           }

استایل (STYLE)
       •   #disk

                                  2026-08-31                    waybar-disk(5)