wl-present(1) General Commands Manual wl-present(1)

wl-present - یک کلاینت تعاملی برای wl-mirror(1)

wl-present [OPTIONS] <COMMAND> [args...]

دستور wl-present یک پوشش (wrapper) برای wl-mirror(1) است که از حالت جاری‌سازی (streaming) آن به همراه pipectl(1) برای کنترل تعاملی محتوای در حال ضبط استفاده می‌کند.

دستورهای فرعی wl-present طوری طراحی شده‌اند که برای دسترسی سریع و آسان، به کلیدهای میانبر در کامپوزیتور wayland شما متصل شوند.

help

نمایش پیام راهنما و خروج.

mirror [OUTPUT] [OPTIONS]

شروع wl-mirror(1) برای ضبط OUTPUT. اگر خروجی مشخص نشود، از slurp(1) برای انتخاب خروجی یا ناحیه جهت ضبط استفاده می‌شود. اگر گزینه‌های OPTIONS اضافی مشخص شده باشد، به wl-mirror ارسال خواهند شد.

set-output [OUTPUT]

تنظیم خروجی ضبط‌شده برای یک نشست در حال اجرای wl-present. اگر خروجی مشخص نشود، از slurp(1) برای انتخاب خروجی جهت ضبط استفاده می‌شود.

set-region [REGION] unset-region

تنظیم ناحیه ضبط‌شده برای یک نشست در حال اجرای wl-present. اگر ناحیه‌ای مشخص نشود، از slurp(1) برای انتخاب ناحیه جهت ضبط استفاده می‌شود.

set-scaling [SCALING]

تنظیم حالت مقیاس‌بندی برای یک نشست در حال اجرای wl-present. اگر مقیاسی مشخص نشود، از dmenu(1) (یا یک جایگزین سازگار) برای انتخاب حالت مقیاس‌بندی استفاده می‌شود.

freeze, unfreeze, toggle-freeze

تنظیم وضعیت انجماد (توقف فریم) برای یک نشست در حال اجرای wl-present.

fullscreen unfullscreen

تنظیم وضعیت تمام‌صفحه برای یک نشست در حال اجرای wl-present.

fullscreen-output [OUTPUT]

تنظیم خروجی مقصد تمام‌صفحه برای یک نشست در حال اجرای wl-present؛ متضمن fullscreen است.

no-fullscreen-output

لغو خروجی مقصد تمام‌صفحه که قبلاً تنظیم شده است در یک نشست در حال اجرای wl-present؛ متضمن unfullscreen است.

custom [OPTIONS]

ارسال گزینه‌های سفارشی به یک نشست در حال اجرای wl-present. اگر گزینه‌ای مشخص نشود، از dmenu(1) (یا یک جایگزین سازگار) برای انتخاب یک گزینه استفاده می‌شود.

-n, --name

استفاده از یک نام پایپ (pipe) جایگزین (پیش‌فرض wl-present است). این امکان اجازه می‌دهد چندین نمونه از wl-present به‌طور هم‌زمان اجرا شوند.

WL_PRESENT_DMENU

پیاده‌سازی dmenu مورد استفاده را جایگزین می‌کند. در صورت تنظیم، این دستور به‌جای حالت پیش‌فرض برای انتخاب گزینه‌ها استفاده می‌شود. در صورت عدم تنظیم، wl-present تلاش می‌کند به‌ترتیب از wofi(1)، wmenu(1)، fuzzel(1)، rofi(1) و dmenu(1) استفاده کند.

مثال: WL_PRESENT_DMENU="rofi -dmenu -p present";

WL_PRESENT_PIPECTL

پیاده‌سازی pipectl مورد استفاده را جایگزین می‌کند. در صورت تنظیم، این دستور برای هدایت گزینه‌ها به wl-mirror(1) به‌جای حالت پیش‌فرض استفاده می‌شود. در صورت عدم تنظیم، wl-present تلاش می‌کند از pipectl(1) یا در صورت در دسترس نبودن آن، از لایهٔ تطبیقی (shim) داخلی نوشته‌شده به زبان bash استفاده کند.

WL_PRESENT_SLURP

پیاده‌سازی و گزینه‌های slurp مورد استفاده را جایگزین می‌کند. در صورت تنظیم، این دستور به‌جای حالت پیش‌فرض برای انتخاب ناحیه‌ها و خروجی‌ها استفاده می‌شود. در صورت عدم تنظیم، wl-present تلاش می‌کند از slurp(1) بدون هیچ گزینهٔ اضافی استفاده کند.

مثال: WL_PRESENT_SLURP="slurp -c #859900 -w 2";

WL_PRESENT_PIPE_NAME

نام پیش‌فرض پایپ را جایگزین می‌کند (پیش‌فرض wl-present است). این متغیر معادل گزینهٔ --name در بالا است.

مثال: WL_PRESENT_PIPE_NAME=monitor2 wl-present mirror HDMI-A-1

نگه‌داری‌شده توسط Ferdinand Bachmann <ferdinand.bachmann@yrlf.at>. اطلاعات بیشتر دربارهٔ wl-mirror در https://github.com/Ferdi265/wl-mirror در دسترس است.

wl-mirror(1) pipectl(1) slurp(1) wofi(1) wmenu(1) fuzzel(1) rofi(1) dmenu(1)

2026-02-10