I3-INPUT(1) i3 Manual I3-INPUT(1)

i3-input - دریافت تعاملی دستور برای مدیر پنجره i3

i3-input [-s <socket>] [-F <format>] [-l <limit>] [-P <prompt>] [-f <font>] [-v]

دستور i3-input ابزاری برای دریافت دستورها (یا بخش‌هایی از یک دستور) نوشته‌شده توسط کاربر و ارسال آن(ها) به i3 است. این ابزار برای نمونه برای دستور mark/goto کاربردی است.

می‌توانید با فشردن کلید Escape، برنامه i3-input را بدون ارسال هیچ دستوری ببندید.

-s <socket>

مسیر سوکت IPC مدیر پنجره i3 را مشخص می‌کند (نیازی به استفاده معمول از این گزینه نیست، زیرا i3-input خودش مسیر را پیدا خواهد کرد).

-F <format>

هر بار تکرار عبارت "%s" در رشته <format> با ورودی کاربر جایگزین شده و نتیجه به عنوان دستور به i3 ارسال می‌شود. مقدار پیش‌فرض "%s" است.

-l <limit>

حداکثر طول مجاز ورودی کاربر را به <limit> نویسه (کاراکتر) محدود می‌کند. هنگامی که طول ورودی کاربر به این مقدار برسد، i3-input به طور خودکار دستور را ارسال و اجرا می‌کند.

-P <prompt>

رشته اعلان <prompt> را در جلوی کادر متنی ورودی کاربر نمایش می‌دهد. رشته اعلان جزو ورودی یا دستور ارسالی کاربر محسوب نمی‌شود.

-f <font>

از فونت اصلی هسته X11 مشخص‌شده استفاده می‌کند (برای انتخاب فونت می‌توانید از xfontsel استفاده کنید).

-v

نمایش نسخه برنامه و خروج.

علامت‌گذاری یک کانتینر با یک نویسه منفرد:

i3-input -F 'mark %s' -l 1 -P 'Mark: '

پرش و رفتن به کانتینر علامت‌گذاری‌شده با مثال بالا:

i3-input -F '[con_mark="%s"] focus' -l 1 -P 'Go to: '

برنامه i3-input منابع مختلف مسیر سوکت را به ترتیب اولویت زیر بررسی و مدیریت می‌کند:

•متغیر محیطی I3SOCK
•در صورت مشخص شدن پارامتر -s، مقدار متغیر I3SOCK نادیده گرفته و جایگزین می‌شود
•اگر هیچ‌کدام در دسترس نباشند، i3-input مسیر سوکت را از ویژگی X11 می‌خواند که روش توصیه‌شده است
•اگر همه موارد با شکست مواجه شوند، i3-input مسیر /tmp/i3-ipc.sock را امتحان می‌کند

مسیر سوکت برای اتصال به i3 و صدور واقعی دستور ضروری است.

i3(1)

Michael Stapelberg و مشارکت‌کنندگان

02/06/2026 i3 4.25.1