نام (NAME)

shikane - پیکربندی پویای قطعی خروجی‌های تصویر

خلاصه دستور (SYNOPSIS)

shikane

shikane [-hV] [-o] [-c file]

shikane [--oneshot] [--config file]

توضیحات (DESCRIPTION)

برنامه shikane (/ʃiˈkaːnə/) یک ابزار پیکربندی پویای خروجی تصویر با تمرکز بر دقت و قطعیت است.

این ابزار به‌طور خودکار نمایشگرهای متصل را بر اساس مجموعه‌ای از پروفایل‌ها شناسایی و پیکربندی می‌کند. هر پروفایل مجموعه‌ای از خروجی‌ها را با پارامترهای اضافی (مانند mode، position، scale) مشخص می‌کند. اگر تمام خروجی‌ها و حالت‌های مشخص‌شده بتوانند دقیقاً با نمایشگرهای متصل فعلی و قابلیت‌های آن‌ها مطابقت یابند، پروفایل به‌طور خودکار اعمال خواهد شد. (برای جزئیات بیشتر به shikane(5) مراجعه کنید.)

این یک معادل Wayland برای ابزارهایی مانند autorandr است. هدف آن جایگزینی کامل kanshi، رفع عدم‌دقت‌های آن و افزودن ویژگی‌های جدید است. برنامه shikane با کامپوزیتورهای Wayland که از نسخه‌های ۳ یا بالاتر پروتکل wlr-output-management پشتیبانی می‌کنند (مانند کامپوزیتورهایی که از wlroots نسخه ۰.۱۶ استفاده می‌کنند) کار می‌کند.

گزینه‌ها (OPTIONS)

-h, --help: نمایش اطلاعات راهنما
-c, --config file: مسیر یک فایل پیکربندی (file)
-o, --oneshot: فعال‌سازی حالت یک‌باره (oneshot)

خروج پس از اعمال شدن یک پروفایل یا در صورت عدم تطابق هیچ پروفایلی

-s, --socket path: بازنویسی مسیر پیش‌فرض سوکت IPC
-T, --timeout timeout: انتظار به میزان timeout میلی‌ثانیه قبل از پردازش تغییرات [پیش‌فرض: 0]
-V, --version: نمایش اطلاعات نسخه

محیط (ENVIRONMENT)

SHIKANE_LOG: کنترل می‌کند که shikane و ماژول‌های آن در چه سطح لاگی پیام‌ها را در stderr چاپ کنند. سطوح لاگ موجود عبارتند از error، warn، info، debug و trace؛ مرتب‌شده از بالاترین تا پایین‌ترین اولویت. سطح لاگ پایین‌تر شامل پیام‌های سطوح بالاتر نیز می‌شود. تنظیم SHIKANE_LOG روی trace به شما امکان مشاهده همه‌چیز را می‌دهد. تنظیم آن روی off تمام لاگ‌گیری را غیرفعال می‌کند.

این متغیر امکان فیلتر کردن بر اساس ماژول‌ها را فراهم کرده و فهرستی جداشده با کاما را می‌پذیرد: SHIKANE_LOG=shikane=warn,shikane::matching=debug تنها هشدارها (warn) و خطاهای (error) shikane را نمایش می‌دهد، به جز ماژول matching که در آن پیام‌های لاگ سطح debug و بالاتر نمایش داده می‌شوند.

نکته: خروجی لاگ و ساختار فیلترسازی یک رابط پایدار نیست و ممکن است در هر زمان تغییر کند.

SHIKANE_LOG_STYLE: کنترل می‌کند که آیا از رنگ‌ها و استایل‌های دارای نویسه‌های ANSI برای خروجی لاگ استفاده شود یا خیر. مقادیر ممکن عبارتند از auto، always و never. پیش‌فرض auto است.
SHIKANE_LOG_TIME: در صورت تنظیم روی 1، ثبت برچسب زمانی (timestamp) پیشوندی را فعال می‌کند.

فایل‌ها (FILES)

برنامه shikane به‌طور پیش‌فرض پیکربندی خود را از $XDG_CONFIG_HOME/shikane/config.toml می‌خواند. اگر هیچ فایل پیکربندی‌ای (file) یافت نشود، برنامه با خطا خارج می‌شود. قالب فایل پیکربندی در shikane(5) مستند شده است.

گزارش باگ‌ها (BUGS)

امیدواریم کمتر از ۴ مورد باشد.

نویسندگان (AUTHORS)

Hendrik Wolff hendrik.wolff@agdsn.me

همچنین ببینید (SEE ALSO)

shikane(5), shikanectl(1)