.TH "kitten-@" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@ \- ارسال دستورات کنترلی به ترمینال kitty از راه دور
.SH "خلاصه دستور (SYNOPSIS)"
.SY "kitten @ [گزینه‌های سراسری] [زیردستور] [گزینه‌های زیردستور] [آرگومان‌های زیردستور]"
.YS
.SH "توضیحات (DESCRIPTION)"
کنترل kitty از طریق ارسال دستورات به آن. برای کارکرد این قابلیت، گزینه allow_remote_control را در
.I kitty.conf
تنظیم کنید. هنگام اجرا بدون هیچ زیردستوری، یک شل تعاملی برای کنترل kitty باز می‌شود.
.SH "دستورات (COMMANDS)"
.TP 2
action
اجرای عمل قابل‌نگاشت مشخص‌شده. همچنین ببینید:
.MR kitten-@-action 1
.TP 2
close-tab
بستن زبانه‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-close-tab 1
.TP 2
close-window
بستن پنجره‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-close-window 1
.TP 2
create-marker
ایجاد نشانگری که متن مشخص‌شده را برجسته می‌کند. همچنین ببینید:
.MR kitten-@-create-marker 1
.TP 2
detach-tab
جدا کردن زبانه‌های مشخص‌شده و قرار دادن آن‌ها در یک پنجره سیستم‌عامل دیگر/جدید. همچنین ببینید:
.MR kitten-@-detach-tab 1
.TP 2
detach-window
جدا کردن پنجره‌های مشخص‌شده و قرار دادن آن‌ها در یک زبانه دیگر/جدید. همچنین ببینید:
.MR kitten-@-detach-window 1
.TP 2
disable-ligatures
کنترل رندر نگاره‌های متصل (ligature). همچنین ببینید:
.MR kitten-@-disable-ligatures 1
.TP 2
env
تغییر متغیرهای محیطی که توسط فرآیندهای فرزند آینده دیده می‌شوند. همچنین ببینید:
.MR kitten-@-env 1
.TP 2
focus-tab
فوکوس روی زبانه مشخص‌شده. همچنین ببینید:
.MR kitten-@-focus-tab 1
.TP 2
focus-window
فوکوس روی پنجره مشخص‌شده. همچنین ببینید:
.MR kitten-@-focus-window 1
.TP 2
get-colors
دریافت رنگ‌های ترمینال. همچنین ببینید:
.MR kitten-@-get-colors 1
.TP 2
get-text
دریافت متن از پنجره مشخص‌شده. همچنین ببینید:
.MR kitten-@-get-text 1
.TP 2
goto-layout
تنظیم چیدمان پنجره. همچنین ببینید:
.MR kitten-@-goto-layout 1
.TP 2
kitten
اجرای یک kitten. همچنین ببینید:
.MR kitten-@-kitten 1
.TP 2
last-used-layout
تغییر به آخرین چیدمان استفاده‌شده. همچنین ببینید:
.MR kitten-@-last-used-layout 1
.TP 2
launch
اجرای یک فرآیند دلخواه در یک پنجره/زبانه جدید. همچنین ببینید:
.MR kitten-@-launch 1
.TP 2
load-config
بارگذاری (مجدد) فایل پیکربندی. همچنین ببینید:
.MR kitten-@-load-config 1
.TP 2
ls
فهرست کردن زبانه‌ها/پنجره‌ها. همچنین ببینید:
.MR kitten-@-ls 1
.TP 2
new-window
باز کردن پنجره جدید. همچنین ببینید:
.MR kitten-@-new-window 1
.TP 2
remove-marker
حذف نشانگر تنظیم‌شده کنونی (در صورت وجود). همچنین ببینید:
.MR kitten-@-remove-marker 1
.TP 2
resize-os-window
تغییر اندازه/نمایش/پنهان‌سازی و غیره برای پنجره‌های مشخص‌شده سیستم‌عامل. همچنین ببینید:
.MR kitten-@-resize-os-window 1
.TP 2
resize-window
تغییر اندازه پنجره‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-resize-window 1
.TP 2
run
اجرای یک برنامه در رایانه‌ای که kitty روی آن در حال اجراست و دریافت خروجی آن. همچنین ببینید:
.MR kitten-@-run 1
.TP 2
scroll-window
اسکرول کردن پنجره‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-scroll-window 1
.TP 2
select-window
انتخاب بصری یک پنجره در زبانه مشخص‌شده. همچنین ببینید:
.MR kitten-@-select-window 1
.TP 2
send-key
ارسال فشرده‌شدن کلیدهای دلخواه به پنجره‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-send-key 1
.TP 2
send-text
ارسال متن دلخواه به پنجره‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-send-text 1
.TP 2
set-background-image
تنظیم تصویر پس‌زمینه. همچنین ببینید:
.MR kitten-@-set-background-image 1
.TP 2
set-background-opacity
تنظیم میزان شفافیت پس‌زمینه. همچنین ببینید:
.MR kitten-@-set-background-opacity 1
.TP 2
set-colors
تنظیم رنگ‌های ترمینال. همچنین ببینید:
.MR kitten-@-set-colors 1
.TP 2
set-enabled-layouts
تنظیم چیدمان‌های فعال در زبانه‌ها. همچنین ببینید:
.MR kitten-@-set-enabled-layouts 1
.TP 2
set-font-size
تنظیم اندازه قلم در پنجره سطح بالای فعال سیستم‌عامل. همچنین ببینید:
.MR kitten-@-set-font-size 1
.TP 2
set-spacing
تنظیم فاصله‌های داخلی و خارجی پنجره. همچنین ببینید:
.MR kitten-@-set-spacing 1
.TP 2
set-tab-color
تغییر رنگ زبانه‌های مشخص‌شده در نوار زبانه‌ها. همچنین ببینید:
.MR kitten-@-set-tab-color 1
.TP 2
set-tab-title
تنظیم عنوان زبانه. همچنین ببینید:
.MR kitten-@-set-tab-title 1
.TP 2
set-user-vars
تنظیم متغیرهای کاربر روی یک پنجره. همچنین ببینید:
.MR kitten-@-set-user-vars 1
.TP 2
set-window-logo
تنظیم لوگوی پنجره. همچنین ببینید:
.MR kitten-@-set-window-logo 1
.TP 2
set-window-title
تنظیم عنوان پنجره. همچنین ببینید:
.MR kitten-@-set-window-title 1
.TP 2
signal-child
ارسال یک سیگنال به فرآیند پیش‌زمینه در پنجره‌های مشخص‌شده. همچنین ببینید:
.MR kitten-@-signal-child 1
.PP
برای دریافت راهنمای یک دستور خاص، دستور زیر را اجرا کنید:
.SY kitten @
command -h
.YS
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.TP
.BI "--to"
نشانی نمونه kitty مورد نظر برای کنترل. متناظر با نشانی داده‌شده به نمونه kitty از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در
.I kitty.conf
است. در صورت مشخص نشدن، متغیر محیطی
.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
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--help, -h" " [=no]"
نمایش راهنما برای این دستور.