نام (NAME)

kitten-quick-access-terminal - پنجره ترمینال دسترسی سریع با قابلیت باز شدن آنی با فشردن یک کلید یا اجرای دستور

نمای کلی (OVERVIEW)

افزوده شده در نسخه 0.42.0: برای پلتفرم‌های پشتیبانی‌شده اینجا را ببینید <#panel-compat>.

این kitten می‌تواند برای ایجاد یک ترمینال دسترسی سریع به کار رود که با فشردن یک کلید ظاهر و پنهان می‌شود. برای این منظور از دستور زیر استفاده کنید:

kitten quick-access-terminal

این دستور را در یک ترمینال اجرا کنید تا یک پنجره دسترسی سریع kitty در بالای صفحه نمایش شما باز شود. با اجرای مجدد دستور، پنجره پنهان خواهد شد.

برای ظاهر و پنهان شدن ترمینال با فشردن یک کلید:

در لینوکس، کافی است دستور بالا را به یک کلید میانبر سراسری در مدیر پنجره خود اختصاص دهید. در macOS، به مسیر System Preferences->Keyboard->Keyboard Shortcuts->Services->General بروید و یک میانبر برای گزینه Quick access to kitty تعیین کنید.

پیکربندی (CONFIGURATION)

می‌توانید ظاهر و رفتار پنجره دسترسی سریع را با ایجاد فایل quick-access-terminal.conf در پوشه پیکربندی kitty خود <#confloc> سفارشی‌سازی نمایید. به‌ویژه، می‌توانید از گزینه kitty_conf برای تغییر تنظیمات گوناگون kitty، منحصراً برای پنجره دسترسی سریع استفاده نمایید.

نکته:

این kitten در پس‌زمینه از panel kitten <> استفاده می‌کند. می‌توانید از روش‌های شرح‌داده‌شده در آنجا <#remote-control-panel> برای کنترل از راه دور پنجره دسترسی سریع بهره ببرید؛ به یاد داشته باشید که kitty_override allow_remote_control=socket-only و kitty_override listen_on=unix:/tmp/whatever را به فایل quick-access-terminal.conf بیفزایید.

دستورالعمل‌های پیکربندی پشتیبانی‌شده در زیر آورده شده‌اند:

ظاهر پنجره (Window appearance)

lines

lines 25

تعداد خطوط نمایش‌یافته در پنل. برای پنل‌های پس‌زمینه، مرکزی و عمودی نادیده گرفته می‌شود. اگر دارای پسوند px باشد، ارتفاع پنل را به جای خطوط بر حسب پیکسل تنظیم می‌کند.

columns

columns 80

تعداد ستون‌های نمایش‌یافته در پنل. برای پنل‌های پس‌زمینه، مرکزی و افقی نادیده گرفته می‌شود. اگر پسوند px داشته باشد، عرض پنل را به جای ستون‌ها بر حسب پیکسل تنظیم می‌کند.

edge

edge top

لبه‌ای از صفحه نمایش که پنل روی آن قرار می‌گیرد. توجه داشته باشید که برخی از مدیرهای پنجره (مانند i3) از قرار دادن پنجره‌های متصل (docked) در لبه‌های چپ و راست پشتیبانی نمی‌کنند. مقدار background به معنای قرار دادن پنل به عنوان "تصویر پس‌زمینه دسکتاپ" است. توجه داشته باشید که هنگام استفاده از sway، اگر پس‌زمینه‌ای در پیکربندی sway خود تنظیم کرده باشید، پس‌زمینه رسم‌شده با این kitten را می‌پوشاند. علاوه بر این، سه مقدار دیگر وجود دارد: center، center-sized و none. مقدار center پنل را به تمام طرف‌ها مهار (anchor) می‌کند و کل صفحه نمایش را می‌پوشاند (در macOS بخشی از صفحه که توسط نوار عنوان و داک پوشانده نشده است). پنل را می‌توان با استفاده از پارامترهای حاشیه (margin) کوچک کرد و در جای مورد نظر قرار داد. مقدار none پنل را به گوشه بالا چپ مهار می‌کند و باید با استفاده از پارامترهای حاشیه جای‌گذاری شود. اندازه آن با گزینه‌های lines و columns تعیین می‌شود. مقدار center-sized دقیقاً مانند none است، با این تفاوت که پنل به جای گوشه بالا چپ در مرکز قرار می‌گیرد و حاشیه‌ها اثری ندارند.

layer

layer overlay

لایه z-index نمایش‌دهنده ترمینال دسترسی سریع را کنترل می‌کند. در لینوکس، اگر می‌خواهید ترمینال دسترسی سریع با سیستم‌های IME تعامل داشته باشد، ممکن است نیاز باشد این گزینه را به top تغییر دهید. برای جزئیات به مستندات kitty +kitten panel --layer <#cmdoption-kitty-kitten-panel-layer> مراجعه نمایید.

background_opacity

background_opacity 0.85

میزان شفافیت (opacity) پس‌زمینه پنجره. این گزینه مشابه گزینه هم‌نام در kitty عمل می‌کند؛ حضور آن در اینجا به دلیل تفاوت مقدار پیش‌فرض آن برای ترمینال دسترسی سریع است.

hide_on_focus_loss

hide_on_focus_loss no

پنهان‌سازی خودکار پنجره در صورت از دست رفتن فوکوس صفحه‌کلید. استفاده از این گزینه مقدار focus_policy را به اجبار روی on-demand تنظیم خواهد کرد.

grab_keyboard

grab_keyboard no

تصاحب صفحه‌کلید. این بدان معناست که میانبرهای سراسری تعریف‌شده در سیستم‌عامل در عوض به kitty فرستاده می‌شوند. در صورتی که بخواهید یک پنجره مدال در سطح سیستم‌عامل بسازید کاربرد دارد. میزان عملکرد مناسب این قابلیت به سیستم‌عامل/مدیر پنجره/محیط دسکتاپ بستگی دارد. در Wayland این قابلیت تنها در صورتی کار می‌کند که کامپوزیتور پروتکل inhibit-keyboard-shortcuts https://wayland.app/protocols/keyboard-shortcuts-inhibit-unstable-v1 را پیاده‌سازی کرده باشد. در macOS، اپل اجازه تصاحب صفحه‌کلید را بدون مجوزهای ویژه به برنامه‌ها نمی‌دهد، بنابراین کار نخواهد کرد.

margin_left

margin_left 0

تنظیم حاشیه چپ پنل، بر حسب پیکسل. برای پنل‌های لبه راست تاثیری ندارد. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند.

margin_right

margin_right 0

تنظیم حاشیه راست پنل، بر حسب پیکسل. برای پنل‌های لبه چپ تاثیری ندارد. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند.

margin_top

margin_top 0

تنظیم حاشیه بالا برای پنل، بر حسب پیکسل. برای پنل‌های لبه پایین تاثیری ندارد. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند.

margin_bottom

margin_bottom 0

تنظیم حاشیه پایین برای پنل، بر حسب پیکسل. برای پنل‌های لبه بالا تاثیری ندارد. فقط در macOS و کامپوزیتورهای Wayland که از پروتکل wlr layer shell پشتیبانی می‌کنند کار می‌کند.

kitty_conf

مسیر فایل پیکربندی مورد استفاده برای kitty هنگام رسم پنجره. می‌تواند چندین بار تعیین شود. به طور پیش‌فرض، فایل معمول kitty.conf استفاده می‌شود. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty حل‌وفصل می‌شوند.

kitty_override

بازنویسی گزینه‌های پیکربندی منفرد kitty؛ می‌تواند چندین بار مشخص شود. نحو: kitty_override name=value. برای نمونه: kitty_override font_size=20.

app_id

app_id kitty-quick-access

در Wayland فضای نام (namespace) سطح پوسته لایه‌ای (layer shell surface) را تنظیم می‌کند. در X11 مقدار WM_CLASS اختصاص‌یافته به پنجره دسترسی سریع را تعیین می‌نماید. (تنها در لینوکس)

output_name

پنل در هر زمان تنها می‌تواند روی یک نمایشگر (خروجی) نمایش داده شود. این گزینه امکان مشخص کردن نام خروجی مورد استفاده را فراهم می‌آورد. در صورت عدم تعیین، کامپوزیتور یک خروجی را به صورت خودکار برمی‌گزیند؛ معمولاً آخرین خروجی که کاربر با آن تعامل داشته یا نمایشگر اصلی. دستور kitten panel --output-name list را برای دریافت فهرستی از خروجی‌های موجود اجرا کنید. برای خروجی با قالب‌بندی json از listjson استفاده نمایید. توجه داشته باشید که در Wayland خروجی تنها در زمان ایجاد پنل قابل تعیین است و پس از ایجاد نمی‌توان آن را تغییر داد، همچنین راهی برای نمایش یک پنل منفرد روی تمامی خروجی‌ها وجود ندارد؛ لطفاً در این خصوص به توسعه‌دهندگان Wayland بازخورد دهید.

start_as_hidden

start_as_hidden no

تعیین اینکه آیا ترمینال دسترسی سریع در ابتدا پنهان باشد یا خیر. در صورتی که آن را به عنوان بخشی از راه‌اندازی اولیه سیستم اجرا می‌کنید سودمند است.

focus_policy

focus_policy exclusive

در یک کامپوزیتور Wayland که از پروتکل wlr layer shell پشتیبانی می‌کند، سیاست فوکوس برای تعامل صفحه‌کلید با پنل را مشخص می‌کند. لطفاً برای جزئیات بیشتر به مستندات پروتکل wlr layer shell رجوع کنید. توجه داشته باشید که کامپوزیتورهای مختلف Wayland با مقدار exclusive رفتارهای بسیار متفاوتی نشان می‌دهند و ممکن است نتیجه برای شما متغیر باشد. در macOS، مقادیر exclusive و on-demand در حال حاضر یکسان هستند.

کد منبع quick_access_terminal

کد منبع این kitten در گیت‌هاب در دسترس است: https://github.com/kovidgoyal/kitty/tree/master/kittens/quick_access_terminal.

رابط خط فرمان (Command line interface)

kitten quick_access_terminal [options] [cmdline-to-run ...]

پنجره ترمینال دسترسی سریع با قابلیت باز شدن آنی با فشردن یک کلید یا اجرای دستور.

گزینه‌ها (OPTIONS)

--config <CONFIG>, -c <CONFIG>

تعیین مسیر فایل(های) پیکربندی مورد استفاده. تمامی فایل‌های پیکربندی با فایل پیش‌فرض داخلی quick-access-terminal.conf ادغام شده و مقادیر پیش‌فرض را بازنویسی می‌کنند. این گزینه می‌تواند چندین بار مشخص شود تا چند فایل پیکربندی را به ترتیب بخواند و ادغام نماید. برای عدم بارگذاری هرگونه فایل پیکربندی، از مقدار ویژه NONE استفاده کنید.

در صورت مشخص نشدن این گزینه، فایل‌های پیکربندی به این ترتیب جستجو می‌شوند: $XDG_CONFIG_HOME/kitty/quick-access-terminal.conf، ~/.config/kitty/quick-access-terminal.conf و $XDG_CONFIG_DIRS/kitty/quick-access-terminal.conf. نخستین فایلی که موجود باشد به عنوان فایل پیکربندی استفاده خواهد شد.

اگر متغیر محیطی KITTY_CONFIG_DIRECTORY <#envvar-KITTY_CONFIG_DIRECTORY> مشخص شده باشد، همیشه آن دایرکتوری استفاده شده و جستجوی بالا انجام نخواهد شد.

اگر /etc/xdg/kitty/quick-access-terminal.conf موجود باشد، پیش از هر فایل پیکربندی کاربری ادغام می‌شود (یعنی با اولویت کمتر). از آن می‌توان برای تعیین پیش‌فرض‌های سراسری سیستم برای همه کاربران استفاده نمود. برای خواندن پیکربندی از ورودی استاندارد (STDIN) می‌توانید از - یا /dev/stdin استفاده نمایید.

--override <OVERRIDE>, -o <OVERRIDE>: بازنویسی گزینه‌های پیکربندی منفرد؛ می‌تواند چندین بار تعیین شود. نحو: name=value. برای مثال: -o lines=12

--detach [=no]: جدا شدن از ترمینال کنترل‌کننده (در صورت وجود) و اجرا به عنوان یک فرآیند فرزند مستقل؛ فرآیند والد بلافاصله پایان می‌یابد.

--detached-log <DETACHED_LOG>: مسیر یک فایل لاگ جهت ذخیره STDOUT/STDERR هنگام استفاده از --detach.

--instance-group <INSTANCE_GROUP>: نام یکتای این ترمینال دسترسی سریع. در صورتی که خواهان چند ترمینال از این نوع هستید از نام‌های متفاوتی استفاده کنید. پیش‌فرض: quick-access

--debug-rendering [=no]: جهت اشکال‌زدایی تعاملات با کامپوزیتور/مدیر پنجره.

--debug-input [=no]: جهت اشکال‌زدایی تعاملات با کامپوزیتور/مدیر پنجره.

نمونه quick-access-terminal.conf

می‌توانید یک فایل نمونه quick-access-terminal.conf به همراه تمامی تنظیمات پیش‌فرض و توضیحات مربوط به هر گزینه را دریافت نمایید: sample quick-access-terminal.conf.

نویسنده (AUTHOR)

Kovid Goyal

حق نشر (COPYRIGHT)

2026, Kovid Goyal