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

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

خلاصه دستور (SYNOPSIS)
       wl-present [OPTIONS] <COMMAND> [args...]

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

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

دستورها (COMMANDS)
       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) (یا یک جایگزین سازگار) برای انتخاب
           یک گزینه استفاده می‌شود.

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

محیط (ENVIRONMENT)
       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

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

همچنین ببینید (SEE ALSO)
       wl-mirror(1) pipectl(1) slurp(1) wofi(1) wmenu(1) fuzzel(1) rofi(1)
       dmenu(1)

                                  2026-02-10                     wl-present(1)