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

نام (NAME)
       waybar-network - ماژول شبکه در waybar

توضیحات (DESCRIPTION)
       ماژول network اطلاعات مربوط به اتصالات شبکه جاری را نمایش می‌دهد.

پیکربندی (CONFIGURATION)
       مخاطب با network

       interface:
       typeof: string
       استفاده از رابط تعریف‌شده به‌جای تشخیص خودکار. کاراکترهای عمومی
       (wildcard) را می‌پذیرد.

       rfkill:
       typeof: bool
       default: true
       در صورت فعال بودن، زمانی که rfkill رابط‌های wlan را مسدود کرده باشد،
       قالب disabled استفاده خواهد شد.

       interval:
       typeof: integer
       default: 60
       فاصله زمانی که اطلاعات شبکه دریافت می‌شود (مثلاً قدرت سیگنال).

       family:
       typeof: string
       default: ipv4
       خانواده آدرسی که برای جایگزینی قالب {ipaddr} و تعیین وجود اتصال شبکه
       استفاده می‌شود. برای نمایش هر دو، آن را روی ipv4_6 تنظیم کنید.

       format:
       typeof: string
       default: {ifname}
       قالب، نحوه نمایش اطلاعات. این قالب زمانی استفاده می‌شود که قالب‌های دیگر
       مشخص نشده باشند.

       format-ethernet:
       typeof: string
       این قالب زمانی استفاده می‌شود که یک رابط اترنت نمایش داده شود.

       format-wifi:
       typeof: string
       این قالب زمانی استفاده می‌شود که یک رابط بی‌سیم نمایش داده شود.

       format-linked:
       typeof: string
       این قالب زمانی استفاده می‌شود که یک رابط متصل بدون آدرس IP نمایش داده
       شود.

       format-disconnected:
       typeof: string
       این قالب زمانی استفاده می‌شود که رابط نمایش‌داده‌شده قطع باشد.

       format-disabled:
       typeof: string
       این قالب زمانی استفاده می‌شود که rfkill رابط‌های wlan را مسدود کرده باشد.

       format-icons:
       typeof: array/object
       بر اساس قدرت سیگنال فعلی، نماد مربوطه انتخاب می‌شود.
       ترتیب از کم به زیاد است. یا در صورتی که یک شیء باشد بر اساس وضعیت.

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

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

       min-length:
       typeof: integer
       حداقل طول برحسب کاراکتر که ماژول باید بپذیرد.

       align:
       typeof: float
       تراز برچسب درون ماژول، که در آن ۰ چپ‌چین و ۱ راست‌چین است. اگر ماژول
       چرخانده شود، از جهت جریان متن پیروی خواهد کرد.

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

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

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

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

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

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

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

       smooth-scrolling-threshold:
       typeof: double
       آستانه‌ای که هنگام پیمایش استفاده می‌شود.

       tooltip:
       typeof: bool
       default: true
       گزینه‌ای برای غیرفعال کردن راهنمای شناور هنگام قرار گرفتن نشانگر ماوس
       روی آن.

       tooltip-format:
       typeof: string
       قالب، نحوه نمایش اطلاعات در راهنمای شناور. این قالب زمانی استفاده می‌شود
       که قالب‌های دیگر مشخص نشده باشند.

       tooltip-format-ethernet:
       typeof: string
       این قالب زمانی استفاده می‌شود که یک رابط اترنت نمایش داده شود.

       tooltip-format-wifi:
       typeof: string
       این قالب زمانی استفاده می‌شود که یک رابط بی‌سیم نمایش داده شود.

       tooltip-format-disconnected:
       typeof: string
       این قالب زمانی استفاده می‌شود که رابط نمایش‌داده‌شده قطع باشد.

       tooltip-format-disabled:
       typeof: string
       این قالب زمانی استفاده می‌شود که rfkill رابط‌های wlan را مسدود کرده باشد.

       menu:
       typeof: string
       کنشی که منو را باز می‌کند.

       menu-file:
       typeof: string
       محل پرونده توصیف‌گر منو. باید عنصری از نوع GtkMenu با شناسه menu وجود
       داشته باشد.

       menu-actions:
       typeof: array
       کنش‌های متناظر با دکمه‌های منو.

       expand:
       typeof: bool
       default: false
       به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به‌طور پویا مصرف کند.

جایگزین‌های قالب (FORMAT REPLACEMENTS)
       {ifname}: نام رابط شبکه.

       {ipaddr}: نخستین IP رابط.

       {gwaddr}: درگاه پیش‌فرض برای رابط

       {netmask}: ماسک زیرشبکه متناظر با IP(V4).

       {netmask6}: ماسک زیرشبکه متناظر با IP(V6).

       {cidr}: ماسک زیرشبکه متناظر با IP(V4) در نماد CIDR.

       {cidr6}: ماسک زیرشبکه متناظر با IP(V6) در نماد CIDR.

       {essid}: نام (SSID) شبکه بی‌سیم.

       {bssid}: آدرس MAC (یا BSSID) نقطه دسترسی بی‌سیم.

       {signalStrength}: قدرت سیگنال شبکه بی‌سیم.

       {signaldBm}: قدرت سیگنال شبکه بی‌سیم برحسب dBm.

       {frequency}: فرکانس شبکه بی‌سیم برحسب گیگاهرتز (GHz).

       {bandwidthUpBits}: سرعت لحظه‌ای بارگذاری برحسب بیت/ثانیه.

       {bandwidthDownBits}: سرعت لحظه‌ای بارگیری برحسب بیت/ثانیه.

       {bandwidthTotalBits}: مجموع سرعت لحظه‌ای برحسب بیت/ثانیه.

       {bandwidthUpOctets}: سرعت لحظه‌ای بارگذاری برحسب هشت‌بایت/ثانیه.

       {bandwidthDownOctets}: سرعت لحظه‌ای بارگیری برحسب هشت‌بایت/ثانیه.

       {bandwidthTotalOctets}: مجموع سرعت لحظه‌ای برحسب هشت‌بایت/ثانیه.

       {bandwidthUpBytes}: سرعت لحظه‌ای بارگذاری برحسب بایت/ثانیه.

       {bandwidthDownBytes}: سرعت لحظه‌ای بارگیری برحسب بایت/ثانیه.

       {bandwidthTotalBytes}: مجموع سرعت لحظه‌ای برحسب بایت/ثانیه.

       {icon}: نماد، مطابق با تعریف در format-icons.

مثال‌ها (EXAMPLES)
           "network": {
                "interface": "wlp2s0",
                "format": "{ifname}",
                "format-wifi": "{essid} ({signalStrength}%) ",
                "format-ethernet": "{ifname} ",
                "format-disconnected": "", //یک قالب خالی ماژول را پنهان می‌کند.
                "format-disconnected": "",
                "tooltip-format": "{ifname}",
                "tooltip-format-wifi": "{essid} ({signalStrength}%) ",
                "tooltip-format-ethernet": "{ifname} ",
                "tooltip-format-disconnected": "Disconnected",
                "max-length": 50
           }

استایل (STYLE)
       •   #network
       •   #network.disconnected
       •   #network.disabled
       •   #network.linked
       •   #network.ethernet
       •   #network.wifi

                                  2026-08-31                 waybar-network(5)