.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "hyprctl" "1" "" "" "راهنمای کاربری hyprctl"
.hy
.SH "نام (NAME)"
.PP
hyprctl \- ابزاری برای واپایش بخش‌هایی از Hyprland از طریق واسط خط فرمان یا اسکریپت
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]hyprctl\f[R] [\f[I](opt)flags\f[R]] [\f[B]command\f[R]]
[\f[I](opt)args\f[R]]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[B]hyprctl\f[R] ابزاری برای واپایش برخی از بخش‌های کامپوزیتور از طریق واسط خط فرمان یا یک اسکریپت است.
.SH "دستورهای کنترلی (CONTROL COMMANDS)"
.PP
\f[B]dispatch\f[R]
.RS
.PP
فراخوانی یک توزیع‌کننده (dispatcher) به همراه یک آرگومان.
.PP
وجود آرگومان الزامی است.
برای توزیع‌کننده‌های بدون پارامتر، این مقدار می‌تواند هر چیزی باشد.
.PP
خروجی: در صورت موفقیت \f[I]ok\f[R] و در صورت شکست یک پیام خطا بازمی‌گرداند.
.TP
مثال‌ها:
\f[B]hyprctl\f[R] \f[I]dispatch "hl.dsp.exec_cmd('kitty')"\f[R]
.RS
.PP
\f[B]hyprctl\f[R] \f[I]dispatch "hl.dsp.window.close()"\f[R]
.RE
.RE
.PP
\f[B]keyword\f[R]
.RS
.PP
تنظیم پویای یک کلیدواژه پیکربندی.
در صورتی که ارائه‌دهنده پیکربندی شما lua باشد، این دستور کار نخواهد کرد (به \f[B]eval\f[R] مراجعه کنید).
.PP
خروجی: در صورت موفقیت \f[I]ok\f[R] و در صورت شکست یک پیام خطا بازمی‌گرداند.
.TP
مثال‌ها:
\f[B]hyprctl\f[R] \f[I]keyword bind SUPER,0,pseudo\f[R]
.RS
.PP
\f[B]hyprctl\f[R] \f[I]keyword general:border_size 10\f[R]
.RE
.RE
.PP
\f[B]eval\f[R]
.RS
.PP
ارزیابی پویای عبارت‌های دلخواه Lua هنگام استفاده از ارائه‌دهنده پیکربندی مبتنی بر Lua.
.PP
خروجی: در صورت موفقیت \f[I]ok\f[R] و در صورت شکست یک پیام خطا بازمی‌گرداند.
.TP
مثال‌ها:
\f[B]hyprctl\f[R] \f[I]eval 'hl.config({ general = { border_size = 10 } })'\f[R]
.RS
.PP
\f[B]hyprctl\f[R] \f[I]eval 'hl.bind("SUPER + SHIFT + Q", hl.dsp.exec_cmd("firefox"))'\f[R]
.RE
.PP
\f[B]reload\f[R]
.RS
.PP
بارگذاری مجدد اجباری فایل پیکربندی.
.RE
.PP
\f[B]kill\f[R]
.RS
.PP
ورود به حالت بستن اجباری (kill mode)، که در آن می‌توانید با کلیک روی یک برنامه آن را ببندید.
با فشردن کلید ESCAPE می‌توانید از این حالت خارج شوید.
.RE
.SH "دستورهای اطلاعاتی (INFO COMMANDS)"
.PP
\f[B]version\f[R]
.RS
.PP
نمایش نسخه Hyprland، پرچم‌ها، کامیت و شاخه ساخت.
.RE
.PP
\f[B]monitors\f[R]
.RS
.PP
فهرست کردن تمام خروجی‌ها به همراه مشخصات آن‌ها.
.RE
.PP
\f[B]workspaces\f[R]
.RS
.PP
فهرست کردن تمام میزهای کار به همراه مشخصات آن‌ها.
.RE
.PP
\f[B]clients\f[R]
.RS
.PP
فهرست کردن تمام پنجره‌ها به همراه مشخصات آن‌ها.
.RE
.PP
\f[B]devices\f[R]
.RS
.PP
فهرست کردن تمام دستگاه‌های ورودی متصل‌شده.
.RE
.PP
\f[B]activewindow\f[R]
.RS
.PP
بازگرداندن نام پنجره فعال.
.RE
.PP
\f[B]layers\f[R]
.RS
.PP
فهرست کردن تمام لایه‌ها.
.RE
.PP
\f[B]splash\f[R]
.RS
.PP
بازگرداندن متن تصادفی صفحه شروع (splash) جاری.
.RE
.PP
\f[B]status\f[R]
.RS
.PP
بازگرداندن اطلاعات وضعیت داخلی مانند ساختار پیکربندی یا بک‌اند.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\f[B]--batch\f[R]
.RS
.PP
مشخص کردن دسته‌ای از دستورها برای اجرا.
.TP
مثال:
\f[B]hyprctl\f[R] \f[I]--batch \[dq]keyword general:border_size 2 ;
keyword general:gaps_out 20\[dq]\f[R]
.RS
.PP
علامت \f[I];\f[R] دستورها را از یکدیگر جدا می‌کند.
.RE
.RE
.PP
\f[B]-j\f[R]
.RS
.PP
نمایش خروجی اطلاعات در قالب JSON.
.RE
.SH "گزارش باگ‌ها (BUGS)"
.TP
گزارش باگ‌ها و درخواست قابلیت‌های جدید را به صورت برخط در نشانی زیر ارسال کنید:
<\f[I]https://github.com/hyprwm/Hyprland/issues\f[R]>
.SH "همچنین ببینید (SEE ALSO)"
.PP
کدهای منبع در: <\f[I]https://github.com/hyprwm/Hyprland\f[R]>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.PP
حق نشر (c) 2022، vaxerski
.SH "نویسندگان (AUTHORS)"
.PP
Vaxerski <\f[I]https://github.com/vaxerski\f[R]>.