.\" Generated by scdoc 1.11.4 .\" Complete documentation for this program is not available as a GNU info page .ie \n(.g .ds Aq \(aq .el .ds Aq ' .nh .ad l .\" Begin generated content: .TH "wpaperd-output" "5" "2026-06-24" .PP .SH "نام (NAME)" .PP wpaperd-output \- قالب مورد استفاده wpaperd برای تعریف نمایشگرهای مختلف .PP .SH "توضیحات (DESCRIPTION)" .PP فایل پیکربندی wpaperd شامل اطلاعات مربوط به هر نمایشگر، تصویر پس‌زمینه متناظر و تنظیمات آن است.\& این فایل در مسیر XDG_CONFIG_HOME/wpaperd/config.\&toml (که به طور پیش‌فرض $HOME/.\&config/wpaperd/config.\&toml است) قرار دارد.\& .PP .SH "نحو (SYNTAX)" .PP این فایل یک پیکربندی ساده به زبان TOML است که به بخش‌هایی تقسیم شده، هر بخش برای یک نمایشگر.\& .PP .SS "بخش‌ها (SECTION)" .PP هر بخش بر اساس شناسه نمایشگر نام‌گذاری می‌شود.\& اگر از \fIsway\fR استفاده می‌کنید، می‌توانید شناسه خروجی را با اجرای دستور زیر بیابید: .PP .nf .RS 4 $ swaymsg -t get_outputs .fi .RE .PP در هایپرلند (Hyprland) می‌توانید این کار را با دستور زیر انجام دهید: .PP .nf .RS 4 $ hyprctl monitors .fi .RE .PP فایل پیکربندی برای \fBwpaperd\fR در `XDG_CONFIG_HOME/wpaperd/config.\&toml` (که به صورت پیش‌فرض `\(ti/.\&config/wpaperd/config.\&toml` است) قرار دارد.\& هر بخش بیانگر یک نمایشگر متفاوت است و می‌تواند کلیدهای زیر را شامل شود: .PP .PD 0 .IP \(bu 4 `path`، مسیر فایل تصویر برای استفاده به عنوان تصویر پس‌زمینه یا پوشه‌ای برای انتخاب تصویر پس‌زمینه از آن .IP \(bu 4 `duration`، مدت زمانی که تصویر باید نمایش داده شود تا با تصویر جدید جایگزین گردد.\& از قالبی خوانا برای انسان جهت تعیین مدت زمان (مانند `30s` یا `10m`) پشتیبانی می‌کند که در [اینجا](https://docs.\&rs/humantime/latest/humantime/fn.\&parse_duration.\&html) شرح داده شده است.\& این گزینه فقط زمانی معتبر است که path به یک پوشه اشاره کند.\& (\fIاختیاری\fR) .IP \(bu 4 `sorting`، انتخاب ترتیب مرتب‌سازی.\& گزینه‌های معتبر عبارتند از `ascending`، `descending` و `random`، که مقدار پیش‌فرض `random` است.\& این گزینه فقط زمانی معتبر است که path به یک پوشه اشاره کند.\& (\fIاختیاری\fR) .IP \(bu 4 `mode`، نحوه نمایش تصویر پس‌زمینه زمانی که اندازه آن با وضوح نمایشگر متفاوت است: \- `fit` کل تصویر را با گوشه‌های سیاه برای پوشاندن فضای خالی باقی‌مانده نمایش می‌دهد \- `center` تصویر را در مرکز صفحه قرار می‌دهد و لبه‌هایی از تصویر که جا نشده‌اند را حذف می‌کند \- `stretch` کل تصویر را با کشیدن آن برای پر کردن کل صفحه بدون باقی گذاشتن لبه‌های سیاه نمایش می‌دهد (نسبت ابعاد تغییر می‌کند) \- `tile` تصویر را چندین بار به صورت افقی و عمودی تکرار می‌کند تا صفحه پر شود .IP \(bu 4 `transition_time`، مدت زمان اجرای گذار (انیمیشن تغییر) بر حسب میلی‌ثانیه.\& (\fIاختیاری\fR، پیش‌فرض `300`).\& .IP \(bu 4 `queue_size`، تعیین اندازه صف زمانی که `path` روی یک پوشه تنظیم شده و `sorting` روی `random` باشد.\& (\fIاختیاری\fR، پیش‌فرض `10`) .IP \(bu 4 `initial_transition`، تعیین این‌که گذار از صفحه سیاه اولیه انجام شود یا خیر (\fIاختیاری\fR، پیش‌فرض `true`) .PD .PP .SS "بخش پیش‌فرض (DEFAULT SECTION)" .PP بخش "\fBdefault\fR" به عنوان پایه برای تمام پیکربندی‌های نمایشگرها استفاده می‌شود؛ بخش "\fBany\fR" برای همه نمایشگرهایی که به صراحت فهرست نشده‌اند به کار می‌رود.\& این امر امکان داشتن پیکربندی انعطاف‌پذیر را بدون تکرار تنظیمات فراهم می‌کند.\& ابزار \fIwpaperd\fR پیکربندی را در هنگام شروع و هر بار که تغییر می‌کند بررسی کرده و در صورت نادرست بودن راهنمایی ارائه می‌دهد.\& .PP .SH "مثال (EXAMPLE)" .PP ساده‌ترین پیکربندی به این شکل است: .PP .nf .RS 4 [DP-3] path = "/home/danyspin97/github_octupus\&.png" [DP-4] path = "/home/danyspin97/Wallpapers" duration = "30m" .fi .RE .PP پیکربندی پیچیده‌تر نیز امکان‌پذیر است: .PP .nf .RS 4 [default] duration = "30m" mode = "center" sorting = "ascending" [any] path = "/home/danyspin97/default_wallpaper\&.png" [DP-3] path = "/home/danyspin97/Wallpapers" .fi .RE .PP .SH "نویسنده (AUTHOR)" نگهداری‌شده توسط Danilo Spinella .\&