.\" 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-quick-access-terminal" 1 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitten-quick-access-terminal \- پنجره ترمینال دسترسی سریع با قابلیت باز شدن آنی با فشردن یک کلید یا اجرای دستور .SH "نمای کلی (OVERVIEW)" .sp افزوده شده در نسخه 0.42.0: برای پلتفرم‌های پشتیبانی‌شده اینجا را ببینید \%<#\:panel-compat>\&. .sp این kitten می‌تواند برای ایجاد یک ترمینال دسترسی سریع به کار رود که با فشردن یک کلید ظاهر و پنهان می‌شود\&. برای این منظور از دستور زیر استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten quick\-access\-terminal .EE .UNINDENT .UNINDENT .sp این دستور را در یک ترمینال اجرا کنید تا یک پنجره دسترسی سریع kitty در بالای صفحه نمایش شما باز شود\&. با اجرای مجدد دستور، پنجره پنهان خواهد شد\&. .sp برای ظاهر و پنهان شدن ترمینال با فشردن یک کلید: .sp در لینوکس، کافی است دستور بالا را به یک کلید میانبر سراسری در مدیر پنجره خود اختصاص دهید\&. در macOS، به مسیر System Preferences\->Keyboard\->Keyboard Shortcuts\->Services\->General بروید و یک میانبر برای گزینه Quick access to kitty تعیین کنید\&. .SH "پیکربندی (CONFIGURATION)" .sp می‌توانید ظاهر و رفتار پنجره دسترسی سریع را با ایجاد فایل \fBquick\-access\-terminal.conf\fP در پوشه پیکربندی kitty خود \%<#\:confloc> سفارشی‌سازی نمایید\&. به‌ویژه، می‌توانید از گزینه \fBkitty_conf\fP برای تغییر تنظیمات گوناگون kitty، منحصراً برای پنجره دسترسی سریع استفاده نمایید\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 این kitten در پس‌زمینه از panel kitten \%<> استفاده می‌کند\&. می‌توانید از روش‌های شرح‌داده‌شده در آنجا \%<#\:remote-control-panel> برای کنترل از راه دور پنجره دسترسی سریع بهره ببرید؛ به یاد داشته باشید که \fBkitty_override allow_remote_control=socket\-only\fP و \fBkitty_override listen_on=unix:/tmp/whatever\fP را به فایل \fBquick\-access\-terminal.conf\fP بیفزایید\&. .UNINDENT .UNINDENT .sp دستورالعمل‌های پیکربندی پشتیبانی‌شده در زیر آورده شده‌اند: .SH "ظاهر پنجره (Window appearance)" .INDENT 0.0 .TP .B lines .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX lines 25 .EE .UNINDENT .UNINDENT .sp تعداد خطوط نمایش‌یافته در پنل\&. برای پنل‌های پس‌زمینه، مرکزی و عمودی نادیده گرفته می‌شود\&. اگر دارای پسوند \fBpx\fP باشد، ارتفاع پنل را به جای خطوط بر حسب پیکسل تنظیم می‌کند\&. .INDENT 0.0 .TP .B columns .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX columns 80 .EE .UNINDENT .UNINDENT .sp تعداد ستون‌های نمایش‌یافته در پنل\&. برای پنل‌های پس‌زمینه، مرکزی و افقی نادیده گرفته می‌شود\&. اگر پسوند \fBpx\fP داشته باشد، عرض پنل را به جای ستون‌ها بر حسب پیکسل تنظیم می‌کند\&. .INDENT 0.0 .TP .B edge .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX edge top .EE .UNINDENT .UNINDENT .sp لبه‌ای از صفحه نمایش که پنل روی آن قرار می‌گیرد\&. توجه داشته باشید که برخی از مدیرهای پنجره (مانند i3) از قرار دادن پنجره‌های متصل (docked) در لبه‌های چپ و راست پشتیبانی نمی‌کنند\&. مقدار \fBbackground\fP به معنای قرار دادن پنل به عنوان \(dqتصویر پس‌زمینه دسکتاپ\(dq است\&. توجه داشته باشید که هنگام استفاده از sway، اگر پس‌زمینه‌ای در پیکربندی sway خود تنظیم کرده باشید، پس‌زمینه رسم‌شده با این kitten را می‌پوشاند\&. علاوه بر این، سه مقدار دیگر وجود دارد: \fBcenter\fP، \fBcenter\-sized\fP و \fBnone\fP\&. مقدار \fBcenter\fP پنل را به تمام طرف‌ها مهار (anchor) می‌کند و کل صفحه نمایش را می‌پوشاند (در macOS بخشی از صفحه که توسط نوار عنوان و داک پوشانده نشده است)\&. پنل را می‌توان با استفاده از پارامترهای حاشیه (margin) کوچک کرد و در جای مورد نظر قرار داد\&. مقدار \fBnone\fP پنل را به گوشه بالا چپ مهار می‌کند و باید با استفاده از پارامترهای حاشیه جای‌گذاری شود\&. اندازه آن با گزینه‌های \fBlines\fP و \fBcolumns\fP تعیین می‌شود\&. مقدار \fBcenter\-sized\fP دقیقاً مانند \fBnone\fP است، با این تفاوت که پنل به جای گوشه بالا چپ در مرکز قرار می‌گیرد و حاشیه‌ها اثری ندارند\&. .INDENT 0.0 .TP .B layer .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX layer overlay .EE .UNINDENT .UNINDENT .sp لایه z\-index نمایش‌دهنده ترمینال دسترسی سریع را کنترل می‌کند\&. در لینوکس، اگر می‌خواهید ترمینال دسترسی سریع با سیستم‌های IME تعامل داشته باشد، ممکن است نیاز باشد این گزینه را به \fBtop\fP تغییر دهید\&. برای جزئیات به مستندات \fBkitty +kitten panel \-\-layer\fP \%<#\:cmdoption-kitty-kitten-panel-layer> مراجعه نمایید\&. .INDENT 0.0 .TP .B background_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_opacity 0.85 .EE .UNINDENT .UNINDENT .sp میزان شفافیت (opacity) پس‌زمینه پنجره\&. این گزینه مشابه گزینه هم‌نام در kitty عمل می‌کند؛ حضور آن در اینجا به دلیل تفاوت مقدار پیش‌فرض آن برای ترمینال دسترسی سریع است\&. .INDENT 0.0 .TP .B hide_on_focus_loss .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX hide_on_focus_loss no .EE .UNINDENT .UNINDENT .sp پنهان‌سازی خودکار پنجره در صورت از دست رفتن فوکوس صفحه‌کلید\&. استفاده از این گزینه مقدار \fBfocus_policy\fP را به اجبار روی \fBon\-demand\fP تنظیم خواهد کرد\&. .INDENT 0.0 .TP .B grab_keyboard .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX grab_keyboard no .EE .UNINDENT .UNINDENT .sp تصاحب صفحه‌کلید\&. این بدان معناست که میانبرهای سراسری تعریف‌شده در سیستم‌عامل در عوض به kitty فرستاده می‌شوند\&. در صورتی که بخواهید یک پنجره مدال در سطح سیستم‌عامل بسازید کاربرد دارد\&. میزان عملکرد مناسب این قابلیت به سیستم‌عامل/مدیر پنجره/محیط دسکتاپ بستگی دارد\&. در Wayland این قابلیت تنها در صورتی کار می‌کند که کامپوزیتور پروتکل inhibit\-keyboard\-shortcuts \% را پیاده‌سازی کرده باشد\&. در macOS، اپل اجازه تصاحب صفحه‌کلید را بدون مجوزهای ویژه به برنامه‌ها نمی‌دهد، بنابراین کار نخواهد کرد\&. .INDENT 0.0 .TP .B margin_left .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_left 0 .EE .UNINDENT .UNINDENT .sp تنظیم حاشیه چپ پنل، بر حسب پیکسل\&. برای پنل‌های لبه راست تاثیری ندارد\&. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند\&. .INDENT 0.0 .TP .B margin_right .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_right 0 .EE .UNINDENT .UNINDENT .sp تنظیم حاشیه راست پنل، بر حسب پیکسل\&. برای پنل‌های لبه چپ تاثیری ندارد\&. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند\&. .INDENT 0.0 .TP .B margin_top .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_top 0 .EE .UNINDENT .UNINDENT .sp تنظیم حاشیه بالا برای پنل، بر حسب پیکسل\&. برای پنل‌های لبه پایین تاثیری ندارد\&. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند\&. .INDENT 0.0 .TP .B margin_bottom .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_bottom 0 .EE .UNINDENT .UNINDENT .sp تنظیم حاشیه پایین برای پنل، بر حسب پیکسل\&. برای پنل‌های لبه بالا تاثیری ندارد\&. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند\&. .INDENT 0.0 .TP .B kitty_conf .UNINDENT .sp مسیر فایل پیکربندی مورد استفاده برای kitty هنگام رسم پنجره\&. می‌تواند چندین بار تعیین شود\&. به طور پیش‌فرض، فایل معمول kitty.conf استفاده می‌شود\&. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty حل‌وفصل می‌شوند\&. .INDENT 0.0 .TP .B kitty_override .UNINDENT .sp بازنویسی گزینه‌های پیکربندی منفرد kitty؛ می‌تواند چندین بار مشخص شود\&. نحو: kitty_override name=value\&. برای نمونه: \fBkitty_override font_size=20\fP\&. .INDENT 0.0 .TP .B app_id .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX app_id kitty\-quick\-access .EE .UNINDENT .UNINDENT .sp در Wayland فضای نام (namespace) سطح پوسته لایه‌ای (layer shell surface) را تنظیم می‌کند\&. در X11 مقدار WM_CLASS اختصاص‌یافته به پنجره دسترسی سریع را تعیین می‌نماید\&. (تنها در لینوکس) .INDENT 0.0 .TP .B output_name .UNINDENT .sp پنل در هر زمان تنها می‌تواند روی یک نمایشگر (خروجی) نمایش داده شود\&. این گزینه امکان مشخص کردن نام خروجی مورد استفاده را فراهم می‌آورد\&. در صورت عدم تعیین، کامپوزیتور یک خروجی را به صورت خودکار برمی‌گزیند؛ معمولاً آخرین خروجی که کاربر با آن تعامل داشته یا نمایشگر اصلی\&. دستور \fBkitten panel \-\-output\-name list\fP را برای دریافت فهرستی از خروجی‌های موجود اجرا کنید\&. برای خروجی با قالب‌بندی json از \fBlistjson\fP استفاده نمایید\&. توجه داشته باشید که در Wayland خروجی تنها در زمان ایجاد پنل قابل تعیین است و پس از ایجاد نمی‌توان آن را تغییر داد، همچنین راهی برای نمایش یک پنل منفرد روی تمامی خروجی‌ها وجود ندارد؛ لطفاً در این خصوص به توسعه‌دهندگان Wayland بازخورد دهید\&. .INDENT 0.0 .TP .B start_as_hidden .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX start_as_hidden no .EE .UNINDENT .UNINDENT .sp تعیین اینکه آیا ترمینال دسترسی سریع در ابتدا پنهان باشد یا خیر\&. در صورتی که آن را به عنوان بخشی از راه‌اندازی اولیه سیستم اجرا می‌کنید سودمند است\&. .INDENT 0.0 .TP .B focus_policy .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX focus_policy exclusive .EE .UNINDENT .UNINDENT .sp در یک کامپوزیتور Wayland که از پروتکل wlr layer shell پشتیبانی می‌کند، سیاست فوکوس برای تعامل صفحه‌کلید با پنل را مشخص می‌کند\&. لطفاً برای جزئیات بیشتر به مستندات پروتکل wlr layer shell رجوع کنید\&. توجه داشته باشید که کامپوزیتورهای مختلف Wayland با مقدار \fBexclusive\fP رفتارهای بسیار متفاوتی نشان می‌دهند و ممکن است نتیجه برای شما متغیر باشد\&. در macOS، مقادیر \fBexclusive\fP و \fBon\-demand\fP در حال حاضر یکسان هستند\&. .SH "کد منبع quick_access_terminal" .sp کد منبع این kitten در گیت‌هاب در دسترس است: \%\&. .SH "رابط خط فرمان (Command line interface)" .INDENT 0.0 .INDENT 3.5 .sp .EX kitten quick_access_terminal [options] [cmdline\-to\-run ...] .EE .UNINDENT .UNINDENT .sp پنجره ترمینال دسترسی سریع با قابلیت باز شدن آنی با فشردن یک کلید یا اجرای دستور\&. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-config , \-c تعیین مسیر فایل(های) پیکربندی مورد استفاده\&. تمامی فایل‌های پیکربندی با فایل پیش‌فرض داخلی \fBquick\-access\-terminal.conf\fP ادغام شده و مقادیر پیش‌فرض را بازنویسی می‌کنند\&. این گزینه می‌تواند چندین بار مشخص شود تا چند فایل پیکربندی را به ترتیب بخواند و ادغام نماید\&. برای عدم بارگذاری هرگونه فایل پیکربندی، از مقدار ویژه \fBNONE\fP استفاده کنید\&. .sp در صورت مشخص نشدن این گزینه، فایل‌های پیکربندی به این ترتیب جستجو می‌شوند: \fB$XDG_CONFIG_HOME/kitty/quick\-access\-terminal.conf\fP، \fB~/.config/kitty/quick\-access\-terminal.conf\fP و \fB$XDG_CONFIG_DIRS/kitty/quick\-access\-terminal.conf\fP\&. نخستین فایلی که موجود باشد به عنوان فایل پیکربندی استفاده خواهد شد\&. .sp اگر متغیر محیطی \fBKITTY_CONFIG_DIRECTORY\fP \%<#\:envvar-KITTY_CONFIG_DIRECTORY> مشخص شده باشد، همیشه آن دایرکتوری استفاده شده و جستجوی بالا انجام نخواهد شد\&. .sp اگر \fB/etc/xdg/kitty/quick\-access\-terminal.conf\fP موجود باشد، پیش از هر فایل پیکربندی کاربری ادغام می‌شود (یعنی با اولویت کمتر)\&. از آن می‌توان برای تعیین پیش‌فرض‌های سراسری سیستم برای همه کاربران استفاده نمود\&. برای خواندن پیکربندی از ورودی استاندارد (STDIN) می‌توانید از \fB\-\fP یا \fB/dev/stdin\fP استفاده نمایید\&. .UNINDENT .INDENT 0.0 .TP .B \-\-override , \-o بازنویسی گزینه‌های پیکربندی منفرد؛ می‌تواند چندین بار تعیین شود\&. نحو: name=value\&. برای مثال: \-o lines=12 .UNINDENT .INDENT 0.0 .TP .B \-\-detach [=no] جدا شدن از ترمینال کنترل‌کننده (در صورت وجود) و اجرا به عنوان یک فرآیند فرزند مستقل؛ فرآیند والد بلافاصله پایان می‌یابد\&. .UNINDENT .INDENT 0.0 .TP .B \-\-detached\-log مسیر یک فایل لاگ جهت ذخیره STDOUT/STDERR هنگام استفاده از \fB\-\-detach\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-instance\-group نام یکتای این ترمینال دسترسی سریع\&. در صورتی که خواهان چند ترمینال از این نوع هستید از نام‌های متفاوتی استفاده کنید\&. پیش‌فرض: \fBquick\-access\fP .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-rendering [=no] جهت اشکال‌زدایی تعاملات با کامپوزیتور/مدیر پنجره\&. .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-input [=no] جهت اشکال‌زدایی تعاملات با کامپوزیتور/مدیر پنجره\&. .UNINDENT .SH "نمونه quick-access-terminal.conf" .sp می‌توانید یک فایل نمونه \fBquick\-access\-terminal.conf\fP به همراه تمامی تنظیمات پیش‌فرض و توضیحات مربوط به هر گزینه را دریافت نمایید: \fBsample quick\-access\-terminal.conf\fP\&. .SH "نویسنده (AUTHOR)" Kovid Goyal .SH "حق نشر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.