.TH "kitten-@-get-colors" "1" "Jul 30, 2026" "0.48.2" "راهنمای kitten"
.SH "نام (NAME)"
kitten-@-get-colors \- دریافت رنگ‌های پیکربندی‌شده در پنجره ترمینال kitty
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ get-colors "
.YS
.SH "توضیحات (DESCRIPTION)"
دریافت رنگ‌های ترمینال برای پنجره مشخص‌شده (به‌طور پیش‌فرض پنجره فعال). رنگ‌ها با همان ساختار نحوی مورد استفاده در
.I kitty.conf
به خروجی استاندارد (STDOUT) فرستاده می‌شوند.
.PP
برای دریافت یک رنگ مشخص، از دستور زیر استفاده کنید:
.PP
.nf
  get\-colors | grep \[dq]\(habackground \[dq] | tr \-s | cut \-d\[dq] \[dq] \-f2
.fi
.PP
در دستور بالا، عبارت background را با هر رنگی که مد نظرتان است جایگزین کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--configured, -c" " [=no]"
به‌جای نمایش رنگ‌های پنجره مشخص‌شده، رنگ‌هایی که در حال حاضر پیکربندی شده‌اند را نمایش می‌دهد.
.TP
.BI "--match, -m"
پنجره‌ای که باید مطابقت داده شود. مشخصات مطابقت به فرم
.I field:query
هستند. که در آن
.I field
می‌تواند یکی از موارد زیر باشد:
.BR id ،
.BR title ،
.BR pid ،
.BR cwd ،
.BR cmdline ،
.BR num ،
.BR env ،
.BR var ،
.BR state ،
.BR neighbor ،
.BR session
و
.BR recent .
شناسه
.I query
عبارتی است که باید مطابقت داده شود. این عبارات می‌توانند یک عدد یا یک عبارت منظم (Regex) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.
.PP
مقدار ویژه
.B all
با همه پنجره‌ها مطابقت دارد.
.PP
برای فیلدهای عددی:
.BR id ،
.BR pid ،
.B num
و
.BR recent ،
عبارت به‌عنوان یک عدد تفسیر می‌شود، نه یک عبارت منظم. مقادیر منفی برای
.B id
از بالاترین شماره شناسه به سمت پایین مطابقت می‌یابند؛ به‌ویژه مقدار
.B \-1
با جدیدترین پنجره ایجادشده مطابقت دارد.
.PP
فیلد
.B num
به موقعیت پنجره در زبانه جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب همان ترتیبی است که پنجره‌ها توسط دستور
.B kitten @ ls
گزارش می‌شوند).
.PP
شناسه پنجره جاری از طریق متغیر محیطی
.B KITTY_WINDOW_ID
در دسترس است.
.PP
فیلد
.B recent
به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد؛ به‌طوری‌که صفر نشان‌دهنده پنجره فعال فعلی، یک نشان‌دهنده پنجره فعال قبلی و به همین ترتیب است.
.PP
فیلد
.B neighbor
به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد:
.BR left ،
.BR right ،
.B top
یا
.BR bottom .
.PP
فیلد
.B session
با پنجره‌هایی که در نشست (session) مشخص‌شده ایجاد شده‌اند مطابقت می‌یابد. از عبارت
.B \(ha$
برای مطابقت با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از
.B .
برای مطابقت با نشست فعال فعلی و از
.B \(ti
برای مطابقت با نشست فعال فعلی یا آخرین نشست فعال (در صورتی که هیچ نشستی فعال نباشد) استفاده کنید.
.PP
هنگام استفاده از فیلد
.B env
برای مطابقت بر اساس متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، برای مثال:
.BR env:MY_ENV_VAR=2 .
.PP
به همین ترتیب، فیلد
.B var
با متغیرهای کاربری تنظیم‌شده روی پنجره مطابقت دارد. می‌توانید مانند فیلد
.B env
تنها نام یا نام و مقدار را تعیین کنید.
.PP
فیلد
.B state
با وضعیت پنجره مطابقت دارد. وضعیت‌های پشتیبانی‌شده عبارتند از:
.BR active ،
.BR focused ،
.BR needs_attention ،
.BR parent_active ،
.BR parent_focused ،
.BR focused_os_window ،
.B self
و
.BR overlay_parent .
پنجره‌های فعال (active) پنجره‌هایی هستند که در زبانه والد خود فعال هستند. تنها یک پنجره دارای فوکوس (focused) وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، با آخرین پنجره فوکوس‌شده مطابقت داده می‌شود. مقدار
.B focused_os_window
با تمام پنجره‌های موجود در پنجره سیستم‌عامل با فوکوس فعلی مطابقت دارد. مقدار
.B self
با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود مطابقت می‌یابد. مقدار
.B overlay_parent
با پنجره‌ای که زیر پنجره
.B self
قرار دارد (هنگامی که پنجره
.B self
یک overlay است) مطابقت دارد.
.PP
توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرست پنجره‌ها استفاده کنید.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنمای این دستور.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
.BI "--to"
آدرسی برای نمونه kitty که باید کنترل شود. مطابق با آدرسی است که از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در فایل
.I kitty.conf
به نمونه kitty داده شده است. در صورت عدم تعیین، متغیر محیطی
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند، یعنی این دستور تنها در صورتی کار خواهد کرد که درون یک پنجره kitty اجرا شود.
.TP
.BI "--password"
گذرواژه‌ای برای استفاده هنگام اتصال به kitty. این گزینه باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بگیرد، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا در
.I kitty.conf
از پیش پیکربندی شده باشد. برای استفاده از گذرواژه خالی،
.B \-\-use\-password
را روی
.B always
تنظیم کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند. برای خواندن از ورودی استاندارد (STDIN) از
.B \-
استفاده کنید. برای خواندن از توصیف‌کننده فایل num از
.B fd:num
استفاده نمایید. در صورتی استفاده می‌شود که گزینه
.B \-\-password
داده نشده باشد. پیش‌فرض بررسی وجود فایل
.I rc\-pass
در دایرکتوری پیکربندی kitty است.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورتی استفاده می‌شود که گزینه
.B \-\-password\-file
ارائه نشده باشد. پیش‌فرض بررسی متغیر محیطی
.B KITTY_RC_PASSWORD
است.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. اگر روی always تنظیم شود و گذرواژه‌ای داده نشود، گذرواژه خالی استفاده می‌شود.
.PP
انتخاب‌ها: if-available, always, never