.TH AUTORANDR 1
.SH "نام (NAME)"
autorandr \- بارگذاری و ذخیره خودکار پیکربندیهای نمایشگر سختافزاری بر پایه xrandr
.SH "خلاصه دستور (SYNOPSIS)"
.B autorandr
[\fIگزینه\fR] [\fIپروفایل\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه به‌طور خودکار سخت‌افزار نمایشگر متصل‌شده را شناسایی کرده و سپس با استفاده از xrandr پیکربندی مناسب X11 را بارگذاری می‌کند. این ابزار همچنین از پروفایل‌های نمایشگر برای پیکربندی‌های سخت‌افزاری مختلف پشتیبانی می‌نماید.
.PP
ابزار autorandr همچنین شامل چندین پیکربندی مجازی از جمله
\fBoff\fR، \fBcommon\fR، \fBclone-largest\fR، \fBhorizontal\fR
و
\fBvertical\fR
است. برای شرح هر یک به مستندات مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش متن راهنما و خروج
.TP
\fB\-c\fR, \fB\-\-change\fR
بارگذاری خودکار اولین پروفایل شناسایی‌شده
.TP
\fB\-d\fR, \fB\-\-default \fIPROFILE\fR
تنظیم پروفایل
\fIPROFILE\fR
به عنوان پروفایل پیش‌فرض. اگر هیچ پروفایل مناسبی شناسایی نشود، پروفایل پیش‌فرض مورد استفاده قرار می‌گیرد؛ در غیر این صورت، پیکربندی فعلی حفظ می‌شود.
.TP
\fB\-l\fR, \fB\-\-load \fIPROFILE\fR
بارگذاری پروفایل
\fIPROFILE\fR
.TP
\fB\-s\fR, \fB\-\-save \fIPROFILE\fR
ذخیره پیکربندی فعلی در پروفایل
\fIPROFILE\fR
.TP
\fB\-r\fR, \fB\-\-remove \fIPROFILE\fR
حذف پروفایل
\fIPROFILE\fR
.TP
.BR \-\-batch
اجرای autorandr برای تمام کاربرانی که نشست‌های فعال X11 دارند
.TP
.BR \-\-current
فقط فهرست کردن پیکربندی(های) فعلی (فعال)
.TP
.BR \-\-config
تخلیه مقادیر متغیرهای پیکربندی فعلی xrandr
.TP
.BR \-\-cycle
چرخش میان تمام پروفایل‌های شناسایی‌شده
.TP
.BR \-\-debug
فعال‌سازی خروجی با جزئیات کامل
.TP
.BR \-\-detected
فقط فهرست کردن پیکربندی(های) شناسایی‌شده (موجود)
.TP
.BR \-\-dry\-run
تغییری اعمال نشود، تنها دستورات xrandr چاپ شوند
.TP
.BR \-\-fingerprint
اثرانگشت‌گیری از پیکربندی سخت‌افزاری فعلی
.TP
.BR \-\-match-edid
تطبیق نمایشگرها بر اساس edid به جای نام
.TP
.BR \-\-ignore-lid
به‌طور پیش‌فرض، در صورت شناسایی خروجی‌های دیگر، درب‌های بسته لپ‌تاپ به عنوان خروجی قطع‌شده در نظر گرفته می‌شوند. این فلگ این رفتار را غیرفعال می‌کند.
.TP
.BR \-\-force
اجبار به بارگذاری یا بارگذاری مجدد یک پروفایل
.TP
.BR \-\-list
فهرست کردن تمام پروفایل‌ها
.TP
\fB\-\-skip\-options\fR [\fIOPTION\fR] ...
تعیین فهرستی جداشده با کاما از آرگومان‌های xrandr جهت صرف‌نظر کردن از آن‌ها در هنگام تشخیص تغییرات و همچنین اعمال پروفایل. برای آرگومان‌های xrandr به
.BR xrandr (1)
مراجعه فرمایید.
.TP
.BR \-\-version
نمایش اطلاعات نسخه و خروج
.SH "فایل‌ها (FILES)"
فایل‌های پیکربندی در دایرکتوری
\fIautorandr\fR
واقع در فهرست مسیرهای جداشده با دونقطه در
\fI$XDG_CONFIG_DIRS\fR
\- یا در
\fI/etc/xdg\fR
اگر این متغیر تنظیم نشده باشد \- جستجو می‌شوند. سپس در
\fI~/.autorandr\fR
و در صورت عدم وجود، در
\fI$XDG_CONFIG_HOME/autorandr\fR
یا اگر این متغیر نیز تنظیم نشده باشد، در
\fI~/.config/autorandr\fR
جستجو خواهند شد.
.PP
در هر یک از این دایرکتوری‌ها، به دنبال دایرکتوری‌هایی حاوی فایل‌های
\fIconfig\fR
و
\fIsetup\fR
می‌گردد. بهتر است این فایل‌ها با استفاده از ابزار
\fBautorandr\fR
مدیریت شوند.

.SH "گزینه‌های پیش‌فرض (DEFAULT OPTIONS)"
می‌توانید مقادیر پیش‌فرض برای هر گزینه‌ای را در یک فایل INI واقع در
\fI~/.config/autorandr/settings.ini\fR
ذخیره کنید. در یک بخش پیکربندی، می‌توانید هر مقدار پیش‌فرضی را به شکل
\fIoption-name=option-argument\fR
قرار دهید.

.SH "اسکریپت‌های قلاب (HOOK SCRIPTS)"
چهار اسکریپت دیگر نیز می‌توانند در دایرکتوری پیکربندی قرار داده شوند:
.TP
\fIpostswitch\fR
پس از تغییر حالت نمایشگر اجرا می‌شود. از این اسکریپت می‌توان برای اطلاع‌رسانی به مدیران پنجره (Window Managers) یا سایر برنامه‌ها درباره تغییر حالت استفاده کرد.
.TP
\fIpreswitch\fR
پیش از تغییر حالت نمایشگر اجرا می‌شود.
.TP
\fIpostsave\fR
پس از ذخیره یا تغییر یک پروفایل اجرا می‌شود.
.TP
\fIpredetect\fR
پیش از اقدام autorandr برای اجرای xrandr اجرا می‌شود.

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

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

.PP
بخشی از وضعیت autorandr در قالب متغیرهای محیطی با پیشوند
\fIAUTORANDR_\fR
ارائه می‌شود، مانند:
\fIAUTORANDR_CURRENT_PROFILE\fR،
\fIAUTORANDR_CURRENT_PROFILES\fR،
\fIAUTORANDR_PROFILE_FOLDER\fR
و
\fIAUTORANDR_MONITORS\fR
با این هدف که بتوان از آن‌ها درون اسکریپت‌های قلاب بهره برد.

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

.SH "نویسندگان (AUTHORS)"
Phillip Berndt <phillip.berndt@googlemail.com>
.br
برای فهرست کامل مشارکت‌کنندگان به https://github.com/phillipberndt/autorandr مراجعه فرمایید.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
مشکلات را در گیت‌هاب بالادست گزارش دهید: https://github.com/phillipberndt/autorandr/issues
.br
در صورت نیاز، خروجی
.B xrandr \-\-verbose
را به گزارش باگ خود ضمیمه کنید.
.SH "همچنین ببینید (SEE ALSO)"
برای مثال‌ها، کاربردهای پیشرفته (شامل قلاب‌های پیش‌تعریف‌شده سرتاسری و به ازای هر پروفایل و تطبیق EDID با الگوهای عامه‌پسند) و مستندات کامل به https://github.com/phillipberndt/autorandr مراجعه کنید.