نام (NAME)

polybar-msg - ارسال پیام‌های IPC به polybar

خلاصه دستور (SYNOPSIS)

polybar-msg [OPTIONS] action action-string
polybar-msg [OPTIONS] action module action [data]
polybar-msg [OPTIONS] cmd command

توضیحات (DESCRIPTION)

نرم‌افزار Polybar امکان کنترل خارجی را از طریق actionها و commandها فراهم می‌کند. دستورهای action ماژول‌های مجزا را کنترل می‌کنند و commandها خودِ نوار را کنترل می‌کنند.

پیوند مستندات کامل IPC در انتهای این سند قرار گرفته است.

دستورهای action دردسترس به ماژول هدف بستگی دارند. برای actionها، بار داده (payload) یا یک رشتهٔ action منفرد است یا نام ماژول، نام action و رشتهٔ دادهٔ اختیاری که به‌صورت مجزا تعیین شده‌اند.

برای اینکه polybar-msg بتواند پیامی را به یک فرایند در حال اجرای polybar ارسال کند، باید IPC در نوار فعال باشد و هر دو ابزار polybar-msg و polybar تحت یک کاربر یکسان اجرا شوند.

گزینه‌ها (OPTIONS)

-h, --help: نمایش متن راهنما و خروج

-p PID: ارسال پیام تنها به فرایند polybar در حال اجرا تحت شناسه فرایند (PID) داده‌شده. در صورت عدم تعیین، پیام به تمام فرایندهای در حال اجرای polybar ارسال می‌شود.

مثال‌ها (EXAMPLES)

polybar-msg cmd quit: خاتمه دادن به تمام نمونه‌های در حال اجرای polybar.

polybar-msg action mymodule module_hide

polybar-msg action "#mymodule.module_hide": پنهان کردن ماژول با نام mymodule. حالت نخست، نام ماژول و action را به‌طور جداگانه تعیین می‌کند و حالت دوم از یک رشتهٔ action استفاده می‌نماید.

نویسندگان (AUTHORS)

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

گزارش باگ‌ها (BUGS)

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

همچنین ببینید (SEE ALSO)

polybar(1), polybar(5)

مستندات IPC: <<https://polybar.rtfd.org/en/stable/user/ipc.html>>

کپی‌رایت و تکثیر (COPYRIGHT)

2016-2026, Michael Carlberg & contributors