.TH "kitten-@-set-window-title" "1" "Jul 30, 2026" "0.48.2" "راهنمای kitten"
.SH "نام (NAME)"
kitten-@-set-window-title \- تنظیم عنوان پنجره
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ set-window-title  [TITLE ...]"
.YS
.SH "توضیحات (DESCRIPTION)"
تنظیم عنوان برای پنجره‌های مشخص‌شده. اگر از گزینه
.B \-\-match
استفاده کنید، عنوان برای تمام پنجره‌های منطبق تنظیم خواهد شد. به‌طور پیش‌فرض، فقط پنجره‌ای که دستور در آن اجرا شده است تحت تأثیر قرار می‌گیرد. اگر عنوانی را مشخص نکنید، آخرین عنوان تنظیم‌شده توسط فرایند فرزند در حال اجرا در پنجره استفاده خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--temporary" " [=no]"
به‌طور پیش‌فرض، عنوان به‌صورت دائمی تغییر خواهد کرد و برنامه‌های در حال اجرا در پنجره دیگر قادر به تغییر مجدد آن نخواهند بود. اگر می‌خواهید به سایر برنامه‌ها اجازه دهید پس از آن عنوان را تغییر دهند، از این گزینه استفاده کنید.
.TP
.BI "--match, -m"
پنجره‌ای که باید تطبیق داده شود. مشخصات تطبیق به فرم \fIfield:query\fR است؛ که در آن \fIfield\fR می‌تواند یکی از موارد زیر باشد: \fBid\fR، \fBtitle\fR، \fBpid\fR، \fBcwd\fR، \fBcmdline\fR، \fBnum\fR، \fBenv\fR، \fBvar\fR، \fBstate\fR، \fBneighbor\fR، \fBsession\fR و \fBrecent\fR. مقدار \fIquery\fR عبارتی است که باید تطبیق داده شود. عبارت‌ها می‌توانند یک عدد یا یک عبارت باقاعده (regular expression) باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی (Boolean) ترکیب نمود.
.sp
مقدار ویژه \fBall\fR با تمام پنجره‌ها تطبیق می‌یابد.
.sp
برای فیلدهای عددی: \fBid\fR، \fBpid\fR، \fBnum\fR و \fBrecent\fR، عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت باقاعده. مقادیر منفی برای \fBid\fR از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه \fB\-1\fR تازه‌ترین پنجره ایجادشده است.
.sp
فیلد \fBnum\fR به موقعیت پنجره در زبانه (tab) جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب مشابه ترتیبی است که پنجره‌ها توسط دستور \fBkitten @ ls\fR گزارش می‌شوند).
.sp
شناسه پنجره جاری از طریق متغیر محیطی
.B KITTY_WINDOW_ID
در دسترس است.
.sp
فیلد \fBrecent\fR به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد، که در آن صفر پنجره در حال حاضر فعال، یک پنجره فعال قبلی و به همین ترتیب است.
.sp
فیلد \fBneighbor\fR به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: \fBleft\fR (چپ)، \fBright\fR (راست)، \fBtop\fR (بالا) یا \fBbottom\fR (پایین).
.sp
فیلد \fBsession\fR پنجره‌هایی را که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق می‌دهد. از عبارت \fB\(ha$\fR برای تطبیق پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از \fB.\fR برای تطبیق نشست در حال حاضر فعال، و از \fB\(ti\fR برای تطبیق نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده کنید.
.sp
هنگام استفاده از فیلد \fBenv\fR برای تطبیق متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، برای مثال: \fBenv:MY_ENV_VAR=2\fR.
.sp
به همین ترتیب، فیلد \fBvar\fR با متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. مانند فیلد \fBenv\fR می‌توانید نام یا نام و مقدار را مشخص کنید.
.sp
فیلد \fBstate\fR با وضعیت پنجره تطبیق داده می‌شود. وضعیت‌های پشتیبانی‌شده عبارتند از: \fBactive\fR، \fBfocused\fR، \fBneeds_attention\fR، \fBparent_active\fR، \fBparent_focused\fR، \fBfocused_os_window\fR، \fBself\fR و \fBoverlay_parent\fR. پنجره‌های فعال (\fBactive\fR) پنجره‌هایی هستند که در زبانه والد خود فعال هستند. تنها یک پنجره فوکوس‌شده (\fBfocused\fR) وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره فوکوس‌شده مطابقت داده می‌شود. مقدار \fBfocused_os_window\fR تمام پنجره‌های موجود در پنجره سیستم‌عامل با فوکوس فعلی را تطبیق می‌دهد. مقدار \fBself\fR با پنجره‌ای که دستور کنترل از راه دور (remote control) در آن اجرا شده است تطبیق می‌یابد. مقدار \fBoverlay_parent\fR پنجره‌ای را که در زیر پنجره \fBself\fR قرار دارد، در صورتی که پنجره \fBself\fR یک پنجره همپوشان (overlay) باشد، تطبیق می‌دهد.
.sp
توجه داشته باشید که می‌توانید از دستور \fBkitten @ ls\fR برای دریافت فهرست پنجره‌ها استفاده کنید.
.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 سنجیده می‌شوند. از
.B \-
برای خواندن از ورودی استاندارد (STDIN) استفاده کنید. از
.B fd:num
برای خواندن از توصیف‌گر پرونده
.I 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
انتخاب‌ها: \fBif\-available\fR، \fBalways\fR، \fBnever\fR