.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "kitten-broadcast" 1 "Jul 30, 2026" "0.48.2" "kitty"
.SH "نام (NAME)"
kitten-broadcast \- ارسال هم‌زمان متن تایپ‌شده به پنجره‌های kitty
.SH "نمای کلی (OVERVIEW)"
.sp
\fIتایپ هم‌زمان متن در تمامی پنجره‌های kitty\fP
.sp
کیتن \fBbroadcast\fP می‌تواند برای تایپ هم‌زمان متن در تمامی پنجره‌های kitty \%<#\:term-window> (یا در صورت تمایل زیرمجموعه‌ای از آن‌ها) به کار رود.
.sp
برای استفاده از آن، کافی است یک نگاشت در \fBkitty.conf\fP ایجاد کنید؛ مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
map f1 launch \-\-allow\-remote\-control kitty +kitten broadcast
.EE
.UNINDENT
.UNINDENT
.sp
سپس کلید \fBF1\fP را فشار دهید؛ هر آنچه در پنجرهٔ تازه ایجادشده تایپ کنید، به تمامی پنجره‌های kitty ارسال خواهد شد.
.sp
می‌توانید از گزینه‌های شرح‌داده‌شده در زیر برای کنترل پنجره‌های انتخاب‌شده استفاده کنید.
.sp
برای مثال، ارسال هم‌زمان فقط به سایر پنجره‌های موجود در زبانهٔ فعلی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
map f1 launch \-\-allow\-remote\-control kitty +kitten broadcast \-\-match\-tab state:focused
.EE
.UNINDENT
.UNINDENT
.SH "کد منبع BROADCAST (SOURCE CODE FOR BROADCAST)"
.sp
کد منبع این کیتن در گیت‌هاب در نشانی \%<https://\:github\:.com/\:kovidgoyal/\:kitty/\:tree/\:master/\:kittens/\:broadcast>\& در دسترس است.
.SH "رابط خط فرمان (COMMAND LINE INTERFACE)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitty +kitten broadcast [options] [initial text to send ...]
.EE
.UNINDENT
.UNINDENT
.sp
ارسال هم‌زمان متن تایپ‌شده به پنجره‌های kitty. به‌طور پیش‌فرض متن به همهٔ پنجره‌ها فرستاده می‌شود، مگر اینکه یکی از گزینه‌های تطبیق مشخص شده باشد.
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-hide\-input\-toggle <HIDE_INPUT_TOGGLE>
کلیدی که برای تغییر وضعیت پنهان‌سازی ورودی در خود پنجرهٔ broadcast فشرده می‌شود. هنگام وارد کردن گذرواژه کاربردی است و از دیده شدن گذرواژه روی صفحه جلوگیری می‌کند.
پیش‌فرض: \fBCtrl+Alt+Esc\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-end\-session <END_SESSION>
کلیدی که برای پایان دادن به نشست broadcast فشرده می‌شود.
پیش‌فرض: \fBCtrl+Esc\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-match <MATCH>, \-m <MATCH>
پنجره‌ای که باید تطبیق داده شود. مشخصات تطبیق به صورت field:query\& هستند؛ که در آن field می‌تواند یکی از موارد زیر باشد: \fBid\fP، \fBtitle\fP، \fBpid\fP، \fBcwd\fP، \fBcmdline\fP، \fBnum\fP، \fBenv\fP، \fBvar\fP، \fBstate\fP، \fBneighbor\fP، \fBsession\fP و \fBrecent\fP\&. بخش query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم (regular expression) باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی (Boolean) ترکیب کرد \%<#\:search-syntax>\&.
.sp
مقدار ویژهٔ \fBall\fP با تمامی پنجره‌ها تطبیق می‌یابد.
.sp
برای فیلدهای عددی: \fBid\fP، \fBpid\fP، \fBnum\fP و \fBrecent\fP، عبارت به عنوان یک عدد تفسیر می‌شود و نه یک عبارت منظم. مقادیر منفی برای \fBid\fP از بزرگ‌ترین شمارهٔ شناسه به سمت پایین تطبیق داده می‌شوند؛ به‌ویژه، \-1 تازه‌ترین پنجرهٔ ایجادشده است.
.sp
فیلد \fBnum\fP به موقعیت پنجره در زبانهٔ فعلی اشاره دارد که از صفر آغاز شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب همان ترتیبی است که پنجره‌ها توسط دستور kitten @ ls \%<#\:at-ls> گزارش می‌شوند).
.sp
شناسهٔ پنجرهٔ فعلی از طریق متغیر محیطی \fBKITTY_WINDOW_ID\fP \%<#\:envvar-KITTY_WINDOW_ID> در دسترس است.
.sp
فیلد \fBrecent\fP به پنجره‌هایی که اخیراً در زبانهٔ فعال فعلی فعال بوده‌اند اشاره دارد؛ به‌طوری‌که صفر پنجرهٔ فعال فعلی، یک پنجرهٔ فعال قبلی و به همین ترتیب است.
.sp
فیلد \fBneighbor\fP به همسایهٔ پنجرهٔ فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: \fBleft\fP، \fBright\fP، \fBtop\fP یا \fBbottom\fP\&.
.sp
فیلد \fBsession\fP با پنجره‌هایی که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت \fB^$\fP برای تطبیق پنجره‌هایی که در یک نشست ایجاد نشده‌اند استفاده کنید، از \fB\&.\fP برای تطبیق نشست فعال فعلی و از \fB~\fP برای تطبیق نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده نمایید.
.sp
هنگام استفاده از فیلد \fBenv\fP برای تطبیق بر اساس متغیرهای محیطی، می‌توانید فقط نام متغیر محیطی یا نام و مقدار را مشخص کنید؛ برای مثال: \fBenv:MY_ENV_VAR=2\fP\&.
.sp
به همین ترتیب، فیلد \fBvar\fP بر اساس متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. مانند فیلد \fBenv\fP می‌توانید نام یا نام و مقدار را مشخص کنید.
.sp
فیلد \fBstate\fP با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: \fBactive\fP، \fBfocused\fP، \fBneeds_attention\fP، \fBparent_active\fP، \fBparent_focused\fP، \fBfocused_os_window\fP، \fBself\fP، \fBoverlay_parent\fP\&. پنجره‌های فعال پنجره‌هایی هستند که در زبانهٔ والد خود فعال‌اند. تنها یک پنجرهٔ فوکوس‌شده وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای فوکوس نشده باشد، آخرین پنجرهٔ فوکوس‌شده تطبیق داده می‌شود. مقدار \fBfocused_os_window\fP با تمام پنجره‌های موجود در پنجرهٔ سیستم‌عامل با فوکوس فعلی تطبیق می‌یابد. مقدار \fBself\fP با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود تطبیق دارد. مقدار \fBoverlay_parent\fP با پنجره‌ای تطبیق می‌یابد که زیر پنجرهٔ \fBself\fP قرار دارد، زمانی که پنجرهٔ self یک پنجرهٔ پوششی (overlay) باشد.
.sp
توجه داشته باشید که می‌توانید از دستور kitten @ ls \%<#\:at-ls> برای دریافت فهرستی از پنجره‌ها استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-match\-tab <MATCH_TAB>, \-t <MATCH_TAB>
زبانه برای تطبیق. مشخصات تطبیق به صورت field:query\& هستند؛ که در آن field می‌تواند یکی از موارد زیر باشد: \fBid\fP، \fBindex\fP، \fBtitle\fP، \fBwindow_id\fP، \fBwindow_title\fP، \fBpid\fP، \fBcwd\fP، \fBcmdline\fP، \fBenv\fP، \fBvar\fP، \fBstate\fP، \fBsession\fP و \fBrecent\fP\&. بخش query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی ترکیب کرد \%<#\:search-syntax>\&.
.sp
مقدار ویژهٔ \fBall\fP با تمامی زبانه‌ها تطبیق می‌یابد.
.sp
برای فیلدهای عددی: \fBid\fP، \fBindex\fP، \fBwindow_id\fP، \fBpid\fP و \fBrecent\fP، عبارت به عنوان یک عدد تفسیر می‌شود و نه یک عبارت منظم. مقادیر منفی برای \fBid\fP/\fBwindow_id\fP از بالاترین شمارهٔ شناسه به پایین تطبیق می‌یابند؛ به‌ویژه، \-1 جدیدترین زبانه/پنجرهٔ ایجادشده است.
.sp
هنگام استفاده از \fBtitle\fP یا \fBid\fP، ابتدا یک زبانهٔ منطبق جستجو می‌شود، و در صورت پیدا نشدن، یک پنجرهٔ منطبق جستجو شده و زبانهٔ مربوط به آن پنجره استفاده می‌شود.
.sp
همچنین می‌توانید از \fBwindow_id\fP و \fBwindow_title\fP برای تطبیق زبانه‌ای که شامل پنجره‌ای با شناسه یا عنوان مشخص‌شده است استفاده کنید.
.sp
عدد \fBindex\fP برای تطبیق n-اُمین زبانه در پنجرهٔ فعال فعلی سیستم‌عامل استفاده می‌شود. عدد \fBrecent\fP زبانه‌های اخیراً فعال در پنجرهٔ فعال فعلی سیستم‌عامل را تطبیق می‌دهد؛ با صفر برای زبانهٔ فعال فعلی، یک برای زبانهٔ فعال قبلی و به همین ترتیب.
.sp
فیلد \fBsession\fP با زبانه‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت \fB^$\fP برای تطبیق پنجره‌هایی که در یک نشست ایجاد نشده‌اند استفاده کنید، از \fB\&.\fP برای تطبیق نشست فعال فعلی و از \fB~\fP برای تطبیق نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده نمایید.
.sp
هنگام استفاده از فیلد \fBenv\fP برای تطبیق بر اساس متغیرهای محیطی، می‌توانید فقط نام متغیر محیطی یا نام و مقدار را مشخص کنید؛ برای مثال: \fBenv:MY_ENV_VAR=2\fP\&. زبانه‌های حاوی هر پنجره‌ای با متغیرهای محیطی مشخص‌شده تطبیق داده می‌شوند. به طور مشابه، \fBvar\fP زبانه‌های حاوی هر پنجره‌ای با متغیر کاربری مشخص‌شده را مطابقت می‌دهد.
.sp
فیلد \fBstate\fP با وضعیت زبانه تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: \fBactive\fP، \fBfocused\fP، \fBneeds_attention\fP، \fBparent_active\fP، \fBparent_focused\fP و \fBfocused_os_window\fP\&. زبانه‌های فعال، زبانه‌هایی هستند که در پنجرهٔ سیستم‌عامل والد خود فعال‌اند. تنها یک زبانهٔ فوکوس‌شده وجود دارد و آن زبانه‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ زبانه‌ای فوکوس نشده باشد، آخرین زبانهٔ فوکوس‌شده تطبیق می‌یابد. مقدار \fBfocused_os_window\fP با تمامی زبانه‌های موجود در پنجرهٔ سیستم‌عامل با فوکوس فعلی تطبیق پیدا می‌کند.
.sp
توجه داشته باشید که می‌توانید از دستور kitten @ ls \%<#\:at-ls> برای دریافت فهرستی از زبانه‌ها استفاده کنید.
.UNINDENT
.SH "نویسندگان (AUTHORS)"

Kovid Goyal
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"

2026, Kovid Goyal
.\" End of generated man page.