.TH "kitten-@-set-window-logo" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-set-window-logo \- تنظیم لوگوی پنجره
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ set-window-logo  PATH_TO_PNG_IMAGE"
.YS
.SH "توضیحات (DESCRIPTION)"
تنظیم تصویر لوگو برای پنجره‌های مشخص‌شده. شما باید مسیر تصویری را که به عنوان لوگو استفاده خواهد شد مشخص کنید. اگر مقدار ویژه none را تعیین کنید، هر لوگوی موجود حذف خواهد شد. قالب‌های تصویری پشتیبانی‌شده عبارتند از: PNG، JPEG، WEBP، GIF، BMP، TIFF
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m" 
پنجره‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت field:query هستند. که در آن field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. عبارت query همان عبارتی است که باید مطابقت داده شود. عبارت‌ها می‌توانند عدد یا عبارت باقاعده (regular expression) باشند و می‌توان آن‌ها را با عملگرهای بولی (Boolean) ترکیب کرد.

مقدار ویژه all با تمام پنجره‌ها مطابقت می‌یابد.

برای فیلدهای عددی: id، pid، num و recent، عبارت به عنوان عدد تفسیر می‌شود و نه عبارت باقاعده. مقادیر منفی برای id از بالاترین شماره id به سمت پایین مطابقت می‌یابند، به‌ویژه \-1 نشان‌دهنده جدیدترین پنجره ایجاد‌شده است.

فیلد num به موقعیت پنجره در زبانه فعلی اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب مشابه ترتیبی است که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره فعلی از طریق متغیر محیطی 
.B KITTY_WINDOW_ID
در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد؛ صفر به معنای پنجره فعال فعلی است، یک به معنای پنجره فعال قبلی و به همین ترتیب.

فیلد neighbor به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: left، right، top یا bottom.

فیلد session با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند مطابقت می‌یابد. از عبارت \(ha$ برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از . برای تطبیق با نشست فعال فعلی و از \(ti برای تطبیق با نشست فعال فعلی یا آخرین نشست فعال در صورتی که هیچ نشستی فعال نباشد، استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق بر روی متغیرهای محیطی، می‌توانید فقط نام متغیر محیطی یا یک نام و مقدار را تعیین کنید، برای مثال: env:MY_ENV_VAR=2.

به طور مشابه، فیلد var با متغیرهای کاربری تنظیم‌شده روی پنجره مطابقت می‌یابد. مانند فیلد env می‌توانید نام یا نام و مقدار را تعیین کنید.

فیلد state بر روی وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self، overlay_parent. پنجره‌های active پنجره‌هایی هستند که در زبانه والد خود فعالند. تنها یک پنجره focused وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای دارای تمرکز نباشد، آخرین پنجره دارای تمرکز مطابقت داده می‌شود. مقدار focused_os_window با تمام پنجره‌های موجود در پنجره سیستم‌عامل متمرکز فعلی مطابقت می‌یابد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود تطبیق دارد. مقدار overlay_parent با پنجره‌ای که زیر پنجره self قرار دارد (هنگامی که پنجره self یک overlay است) مطابقت می‌یابد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرستی از پنجره‌ها استفاده کنید.
.TP
.BI "--self" " [=no]"
اعمال روی پنجره‌ای که این دستور در آن اجرا می‌شود، به‌جای پنجره فعال.
.TP
.BI "--position" 
موقعیت لوگوی پنجره. رجوع کنید به 
.B window_logo_position.
.TP
.BI "--alpha" " [=\-1]"
میزان محو شدن لوگوی پنجره در پس‌زمینه. رجوع کنید به 
.B window_logo_position.
.TP
.BI "--no-response" " [=no]"
منتظر پاسخ از kitty نمانید. این بدان معناست که حتی در صورت ناموفق بودن تنظیم تصویر، دستور با کد خروج موفقیت‌آمیز به پایان می‌رسد.
.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
را برابر always مشخص کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی بر اساس دایرکتوری پیکربندی kitty تفکیک می‌شوند. از \- برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل 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 تنظیم شود و گذرواژه‌ای ارائه نشود، گذرواژه خالی استفاده می‌شود.

انتخاب‌ها: if-available، always، never