.TH "kitten-@-select-window" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-select-window \- انتخاب بصری پنجره در ترمینال kitty
.SH "خلاصه دستور (SYNOPSIS)"
.SY "kitten @ select-window "
.YS
.SH "توضیحات (DESCRIPTION)"
شناسه (\fIid\fR) پنجره انتخاب‌شده را چاپ می‌کند. سپس می‌توان دستورات دیگر را برای استفاده از آن به یکدیگر زنجیر کرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
تب مورد نظر برای تطبیق. مشخصات تطبیق به صورت \fIfield:query\fR هستند. فیلد می‌تواند یکی از موارد زیر باشد:
\fIid\fR، \fIindex\fR، \fItitle\fR، \fIwindow_id\fR، \fIwindow_title\fR، \fIpid\fR، \fIcwd\fR، \fIcmdline\fR، \fIenv\fR، \fIvar\fR، \fIstate\fR، \fIsession\fR و \fIrecent\fR.
عبارت \fIquery\fR همان عبارتی است که باید تطبیق داده شود. عبارت‌ها می‌توانند یک عدد یا یک عبارت باقاعده (regex) باشند و با عملگرهای بولی ترکیب شوند.
.sp
مقدار ویژه
.B all
با تمام تب‌ها مطابقت دارد.
.sp
برای فیلدهای عددی:
\fIid\fR، \fIindex\fR، \fIwindow_id\fR، \fIpid\fR و \fIrecent\fR،
عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت باقاعده. مقادیر منفی برای \fIid/window_id\fR از بالاترین شماره شناسه به پایین مطابقت می‌یابند؛ به ویژه،
.B \-1
نشان‌دهنده جدیدترین تب/پنجره ایجاد‌شده است.
.sp
هنگام استفاده از
.I title
یا
.IR id ،
ابتدا به دنبال تب منطبق گشته می‌شود و در صورت پیدا نشدن، به دنبال یک پنجره منطبق جستجو شده و تب مربوط به آن پنجره استفاده می‌شود.
.sp
همچنین می‌توانید از
.I window_id
و
.I window_title
برای تطبیق تبی که شامل پنجره‌ای با شناسه یا عنوان مشخص‌شده است استفاده کنید.
.sp
شماره
.I index
برای تطبیق n-امین تب در پنجره فعال سیستم‌عامل استفاده می‌شود. شماره
.I recent
با تب‌های اخیراً فعال در پنجره فعال سیستم‌عامل مطابقت دارد که صفر تب فعال کنونی، یک تب قبلاً فعال و به همین ترتیب است.
.sp
فیلد
.I session
با تب‌هایی که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق داده می‌شود. از عبارت
\(ha$
برای تطبیق پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از
.B .
برای تطبیق نشست فعال کنونی و از
\(ti
برای تطبیق نشست فعال کنونی یا آخرین نشست فعال (زمانی که هیچ نشستی فعال نیست) استفاده کنید.
.sp
هنگام استفاده از فیلد
.I env
برای تطبیق روی متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، برای نمونه،
.BR env:MY_ENV_VAR=2 .
تب‌های حاوی هر پنجره‌ای با متغیرهای محیطی مشخص‌شده تطبیق داده می‌شوند. به طور مشابه،
.I var
با تب‌های حاوی هر پنجره‌ای با متغیر کاربری مشخص‌شده مطابقت می‌یابد.
.sp
فیلد
.I state
بر اساس وضعیت تب مطابقت می‌دهد. وضعیت‌های پشتیبانی‌شده عبارتند از:
\fIactive\fR، \fIfocused\fR، \fIneeds_attention\fR، \fIparent_active\fR، \fIparent_focused\fR و \fIfocused_os_window\fR.
تب‌های فعال تب‌هایی هستند که در پنجره والد سیستم‌عامل خود فعال هستند. تنها یک تب دارای فوکوس وجود دارد و آن تبی است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ تبی فوکوس نداشته باشد، آخرین تب فوکوس‌شده مطابقت داده می‌شود. مقدار
.I focused_os_window
با تمام تب‌های موجود در پنجره سیستم‌عامل دارای فوکوس فعلی مطابقت دارد.
.sp
توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرست تب‌ها استفاده کنید.
.TP
.BI "--response-timeout" " [=60]"
مدت زمان به ثانیه برای انتظار جهت انتخاب پنجره توسط کاربر.
.TP
.BI "--self" " [=no]"
انتخاب پنجره از تبی که شامل پنجره‌ای است که این دستور در آن اجرا می‌شود، به جای تب فعال.
.TP
.BI "--title"
عنوانی که برای توصیف هدف این انتخاب به کاربر نمایش داده می‌شود.
.TP
.BI "--exclude-active" " [=no]"
مستثنی کردن پنجره فعال فعلی از فهرست پنجره‌های قابل انتخاب.
.TP
.BI "--reactivate-prev-tab" " [=no]"
هنگامی که انتخاب به پایان رسید، تبی در همان پنجره سیستم‌عامل که قبل از انتخاب فعال بود، دوباره فعال خواهد شد. همچنین روی آخرین پنجره فعال سیستم‌عامل دوباره فوکوس می‌شود.
.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 معمولاً فقط دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. اگر روی
.B always
تنظیم شود و هیچ گذرواژه‌ای ارائه نشود، گذرواژه خالی استفاده می‌شود.
.sp
گزینه‌های قابل انتخاب: if-available، always، never