POLYBAR(1) Polybar User Manual POLYBAR(1)

polybar - یک ابزار نوار وضعیت سریع و با کاربرد آسان

polybar [OPTIONS]... [BAR]

هدف Polybar کمک به کاربران در ساخت نوارهای وضعیت زیبا و با قابلیت شخصی‌سازی بالا برای محیط میزکارشان است، بدون آنکه نیازی به داشتن مهارت پیشرفته در اسکریپت‌نویسی شل باشد. اگر آرگومان BAR مشخص نشود و فایل پیکربندی تنها شامل تعریف یک نوار باشد، polybar همان نوار را نمایش خواهد داد.

نمایش متن راهنما و خروج
نمایش جزئیات ساخت و خروج
تنظیم میزان پرگویی ثبت وقایع (پیش‌فرض: notice)
مقدار LEVEL یکی از این موارد است: error، warning، notice، info، trace
حالت بی‌صدا (تنظیم -l را لغو می‌کند)
تعیین مسیر فایل پیکربندی. به‌طور پیش‌فرض، فایل پیکربندی از این مسیرها بارگذاری می‌شود:
  • $XDG_CONFIG_HOME/polybar/config
  • $XDG_CONFIG_HOME/polybar/config.ini
  • $HOME/.config/polybar/config
  • $HOME/.config/polybar/config.ini
  • $XDG_CONFIG_DIRS/polybar/config.ini
  • /etc/xdg/polybar/config.ini (تنها در صورتی که XDG_CONFIG_DIRS تعیین نشده باشد)
  • /etc/polybar/config.ini
بارگذاری مجدد برنامه هنگام اصلاح فایل پیکربندی
چاپ مقدار پارامتر مشخص‌شدهٔ PARAM در بخش نوار و خروج
چاپ فهرست نمایشگرهای دردسترس و خروج.
اگر برخی نمایشگرها کلون شده باشند، همه به‌جز یکی از آن‌ها نادیده گرفته می‌شوند.
اگر polybar با پشتیبانی از نمایشگرهای RandR کامپایل شده باشد، تنها نمایشگرها فهرست می‌شوند و نه خروجی‌های فیزیکی.
چاپ فهرست تمام نمایشگرهای دردسترس و خروج.
این مورد شامل نمایشگرهای کلون‌شده و همچنین هر دو نوع خروجی‌های فیزیکی و نمایشگرهای RandR (در صورت پشتیبانی) می‌شود.
تنها نام‌های فهرست‌شده در اینجا می‌توانند به‌عنوان نام نمایشگر در polybar استفاده شوند.
چاپ WM_NAME تولیدشده و خروج
ارسال خروجی داده‌ها به stdout به‌جای رسم آن در پنجرهٔ X
ذخیره تصویر لحظه‌ای با فرمت png در FILE پس از ۳ ثانیه اجرا

Polybar توسط Michael Carlberg ساخته شده است و در حال حاضر توسط Patrick Ziegler نگهداری می‌شود.
فهرست مشارکت‌کنندگان در GitHub در دسترس است.

گزارش مشکلات در GitHub https://github.com/polybar/polybar

polybar-msg(1), polybar(5)

مستندات کامل در: <https://github.com/polybar/polybar>
ویکی پروژه: <https://github.com/polybar/polybar/wiki>

2016-2026, Michael Carlberg و مشارکت‌کنندگان

September 1, 2026 3.7.2