hyprctl(1)                  راهنمای کاربری hyprctl                  hyprctl(1)

نام (NAME)
       hyprctl - ابزاری برای واپایش بخش‌هایی از Hyprland از طریق واسط خط فرمان
       یا اسکریپت

خلاصه دستور (SYNOPSIS)
       hyprctl [(opt)flags] [command] [(opt)args]

توضیحات (DESCRIPTION)
       دستور hyprctl ابزاری برای واپایش برخی از بخش‌های کامپوزیتور از طریق واسط
       خط فرمان یا یک اسکریپت است.

دستورهای کنترلی (CONTROL COMMANDS)
       dispatch

              فراخوانی یک توزیع‌کننده (dispatcher) به همراه یک آرگومان.

              وجود آرگومان الزامی است.  برای توزیع‌کننده‌های بدون پارامتر، این
              مقدار می‌تواند هر چیزی باشد.

              خروجی: در صورت موفقیت ok و در صورت شکست یک پیام خطا بازمی‌گرداند.

              مثال‌ها:
                     hyprctl dispatch "hl.dsp.exec_cmd('kitty')"

                     hyprctl dispatch "hl.dsp.window.close()"

       keyword

              تنظیم پویای یک کلیدواژه پیکربندی.  در صورتی که ارائه‌دهنده
              پیکربندی شما lua باشد، این دستور کار نخواهد کرد (به eval مراجعه
              کنید).

              خروجی: در صورت موفقیت ok و در صورت شکست یک پیام خطا بازمی‌گرداند.

              مثال‌ها:
                     hyprctl keyword bind SUPER,0,pseudo

                     hyprctl keyword general:border_size 10

       eval

              ارزیابی پویای عبارت‌های دلخواه Lua هنگام استفاده از ارائه‌دهنده
              پیکربندی مبتنی بر Lua.

              خروجی: در صورت موفقیت ok و در صورت شکست یک پیام خطا بازمی‌گرداند.

              مثال‌ها:
                     hyprctl eval 'hl.config({ general = { border_size = 10 }
                     })'

                     hyprctl eval 'hl.bind("SUPER + SHIFT + Q",
                     hl.dsp.exec_cmd("firefox"))'

              reload

                     بارگذاری مجدد اجباری فایل پیکربندی.

              kill

                     ورود به حالت بستن اجباری (kill mode)، که در آن می‌توانید
                     با کلیک روی یک برنامه آن را ببندید.  با فشردن کلید ESCAPE
                     می‌توانید از این حالت خارج شوید.

دستورهای اطلاعاتی (INFO COMMANDS)
       version

              نمایش نسخه Hyprland، پرچم‌ها، کامیت و شاخه ساخت.

       monitors

              فهرست کردن تمام خروجی‌ها به همراه مشخصات آن‌ها.

       workspaces

              فهرست کردن تمام میزهای کار به همراه مشخصات آن‌ها.

       clients

              فهرست کردن تمام پنجره‌ها به همراه مشخصات آن‌ها.

       devices

              فهرست کردن تمام دستگاه‌های ورودی متصل‌شده.

       activewindow

              بازگرداندن نام پنجره فعال.

       layers

              فهرست کردن تمام لایه‌ها.

       splash

              بازگرداندن متن تصادفی صفحه شروع (splash) جاری.

       status

              بازگرداندن اطلاعات وضعیت داخلی مانند ساختار پیکربندی یا بک‌اند.

گزینه‌ها (OPTIONS)
       --batch

              مشخص کردن دسته‌ای از دستورها برای اجرا.

              مثال:  hyprctl --batch "keyword general:border_size 2 ; keyword
                     general:gaps_out 20"

                     علامت ; دستورها را از یکدیگر جدا می‌کند.

       -j

              نمایش خروجی اطلاعات در قالب JSON.

گزارش باگ‌ها (BUGS)
       گزارش باگ‌ها و درخواست قابلیت‌های جدید را به صورت برخط در نشانی زیر ارسال
       کنید:  <https://github.com/hyprwm/Hyprland/issues>

همچنین ببینید (SEE ALSO)
       کدهای منبع در: <https://github.com/hyprwm/Hyprland>

کپی‌رایت و تکثیر (COPYRIGHT)
       حق نشر (c) 2022، vaxerski

نویسندگان (AUTHORS)
       Vaxerski <https://github.com/vaxerski>.

                                                                    hyprctl(1)