AUTORANDR(1) General Commands Manual AUTORANDR(1)

autorandr - بارگذاری و ذخیره خودکار پیکربندیهای نمایشگر سختافزاری بر پایه xrandr

autorandr [گزینه] [پروفایل]

این برنامه به‌طور خودکار سخت‌افزار نمایشگر متصل‌شده را شناسایی کرده و سپس با استفاده از xrandr پیکربندی مناسب X11 را بارگذاری می‌کند. این ابزار همچنین از پروفایل‌های نمایشگر برای پیکربندی‌های سخت‌افزاری مختلف پشتیبانی می‌نماید.

ابزار autorandr همچنین شامل چندین پیکربندی مجازی از جمله off، common، clone-largest، horizontal و vertical است. برای شرح هر یک به مستندات مراجعه کنید.

نمایش متن راهنما و خروج
بارگذاری خودکار اولین پروفایل شناسایی‌شده
تنظیم پروفایل PROFILE به عنوان پروفایل پیش‌فرض. اگر هیچ پروفایل مناسبی شناسایی نشود، پروفایل پیش‌فرض مورد استفاده قرار می‌گیرد؛ در غیر این صورت، پیکربندی فعلی حفظ می‌شود.
بارگذاری پروفایل PROFILE
ذخیره پیکربندی فعلی در پروفایل PROFILE
حذف پروفایل PROFILE
اجرای autorandr برای تمام کاربرانی که نشست‌های فعال X11 دارند
فقط فهرست کردن پیکربندی(های) فعلی (فعال)
تخلیه مقادیر متغیرهای پیکربندی فعلی xrandr
چرخش میان تمام پروفایل‌های شناسایی‌شده
فعال‌سازی خروجی با جزئیات کامل
فقط فهرست کردن پیکربندی(های) شناسایی‌شده (موجود)
تغییری اعمال نشود، تنها دستورات xrandr چاپ شوند
اثرانگشت‌گیری از پیکربندی سخت‌افزاری فعلی
تطبیق نمایشگرها بر اساس edid به جای نام
به‌طور پیش‌فرض، در صورت شناسایی خروجی‌های دیگر، درب‌های بسته لپ‌تاپ به عنوان خروجی قطع‌شده در نظر گرفته می‌شوند. این فلگ این رفتار را غیرفعال می‌کند.
اجبار به بارگذاری یا بارگذاری مجدد یک پروفایل
فهرست کردن تمام پروفایل‌ها
تعیین فهرستی جداشده با کاما از آرگومان‌های xrandr جهت صرف‌نظر کردن از آن‌ها در هنگام تشخیص تغییرات و همچنین اعمال پروفایل. برای آرگومان‌های xrandr به xrandr(1) مراجعه فرمایید.
نمایش اطلاعات نسخه و خروج

فایل‌های پیکربندی در دایرکتوری autorandr واقع در فهرست مسیرهای جداشده با دونقطه در $XDG_CONFIG_DIRS - یا در /etc/xdg اگر این متغیر تنظیم نشده باشد - جستجو می‌شوند. سپس در ~/.autorandr و در صورت عدم وجود، در $XDG_CONFIG_HOME/autorandr یا اگر این متغیر نیز تنظیم نشده باشد، در ~/.config/autorandr جستجو خواهند شد.

در هر یک از این دایرکتوری‌ها، به دنبال دایرکتوری‌هایی حاوی فایل‌های config و setup می‌گردد. بهتر است این فایل‌ها با استفاده از ابزار autorandr مدیریت شوند.

می‌توانید مقادیر پیش‌فرض برای هر گزینه‌ای را در یک فایل INI واقع در ~/.config/autorandr/settings.ini ذخیره کنید. در یک بخش پیکربندی، می‌توانید هر مقدار پیش‌فرضی را به شکل option-name=option-argument قرار دهید.

چهار اسکریپت دیگر نیز می‌توانند در دایرکتوری پیکربندی قرار داده شوند:

پس از تغییر حالت نمایشگر اجرا می‌شود. از این اسکریپت می‌توان برای اطلاع‌رسانی به مدیران پنجره (Window Managers) یا سایر برنامه‌ها درباره تغییر حالت استفاده کرد.
پیش از تغییر حالت نمایشگر اجرا می‌شود.
پس از ذخیره یا تغییر یک پروفایل اجرا می‌شود.
پیش از اقدام autorandr برای اجرای xrandr اجرا می‌شود.

این اسکریپت‌ها باید دارای مجوز اجرا (executable) باشند و می‌توانند مستقیماً در دایرکتوری پیکربندی قرار گیرند (جایی که همیشه اجرا خواهند شد)، یا در زیردایرکتوری‌های مربوط به هر پروفایل مستقر شوند (جایی که تنها هنگام تغییرات مرتبط با همان پروفایل خاص اجرا می‌گردند).

به‌جای این اسکریپت‌ها (یا علاوه بر آن‌ها)، می‌توانید هر تعداد فایل اجرایی دلخواه را در زیردایرکتوری‌هایی با نام script_name.d (مانند postswitch.d) قرار دهید.

بخشی از وضعیت autorandr در قالب متغیرهای محیطی با پیشوند AUTORANDR_ ارائه می‌شود، مانند: AUTORANDR_CURRENT_PROFILE، AUTORANDR_CURRENT_PROFILES، AUTORANDR_PROFILE_FOLDER و AUTORANDR_MONITORS با این هدف که بتوان از آن‌ها درون اسکریپت‌های قلاب بهره برد.

تنها نکته خاص این است که در طول اجرای preswitch، متغیر AUTORANDR_CURRENT_PROFILE پروفایل آینده را به جای پروفایل فعلی گزارش می‌دهد.

Phillip Berndt <phillip.berndt@googlemail.com>
برای فهرست کامل مشارکت‌کنندگان به https://github.com/phillipberndt/autorandr مراجعه فرمایید.

مشکلات را در گیت‌هاب بالادست گزارش دهید: https://github.com/phillipberndt/autorandr/issues
در صورت نیاز، خروجی xrandr --verbose را به گزارش باگ خود ضمیمه کنید.

برای مثال‌ها، کاربردهای پیشرفته (شامل قلاب‌های پیش‌تعریف‌شده سرتاسری و به ازای هر پروفایل و تطبیق EDID با الگوهای عامه‌پسند) و مستندات کامل به https://github.com/phillipberndt/autorandr مراجعه کنید.