.\" Generated by scdoc 1.11.3
.\" 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 "swayidle" "1" "2025-11-06"
.PP
.SH "نام (NAME)"
.PP
swayidle \- مدیر وضعیت بیکاری برای Wayland
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBswayidle\fR [options] [events.\&.\&.\&]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-C\fR <path>
.RS 4
فایل پیکربندی مورد استفاده.\& به‌طور پیش‌فرض، مسیرهای زیر با ترتیب مشخص‌شده بررسی می‌شوند: $XDG_CONFIG_HOME/swayidle/config و $HOME/.\&swayidle/config.\&
مدخل‌های فایل پیکربندی رویدادهایی هستند که در بخش «رویدادها (EVENTS)» توضیح داده شده‌اند.\&
مشخص کردن رویدادها در پیکربندی و به عنوان آرگومان با یکدیگر مانعة‌الجمع نیستند.\&
.PP
.RE
\fB-h\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-d\fR
.RS 4
فعال‌سازی خروجی اشکال‌زدایی (debug).\&
.PP
.RE
\fB-w\fR
.RS 4
انتظار برای اتمام اجرای دستور پیش از ادامه دادن؛ برای اطمینان از این‌که دستور \fBbefore-sleep\fR پیش از به خواب رفتن سیستم به پایان رسیده باشد مفید است.\&
.PP
نکته: استفاده از این گزینه باعث می‌شود swayidle تا زمان پایان یافتن دستور متوقف (مسدود) بماند.\&
.PP
.RE
\fB-S\fR <seat-name>
.RS 4
مشخص کردن seat مورد استفاده.\& به‌طور پیش‌فرض، اگر نامی تعیین نشده باشد، یک seat دلخواه انتخاب خواهد شد.\&
.PP
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ swayidle به فعالیت‌های بیکاری در کامپوزیتور Wayland شما گوش فرا می‌دهد و با وقوع رویدادهای گوناگونِ مرتبط با بیکاری، وظایفی را اجرا می‌کند.\& شما می‌توانید هر تعداد رویداد را در خط فرمان و در فایل پیکربندی مشخص کنید.\&
.PP
.SH "رویدادها (EVENTS)"
.PP
\fBtimeout\fR <timeout> <timeout command> [resume <resume command>]
.RS 4
اگر برای مدت <timeout> ثانیه فعالیتی نباشد، دستور \fItimeout command\fR را اجرا می‌کند.\&
.PP
اگر عبارت "resume <resume command>" را مشخص کنید، هنگام شروع مجدد فعالیت، دستور \fIresume command\fR اجرا خواهد شد.\&
.PP
.RE
\fBbefore-sleep\fR <command>
.RS 4
اگر همراه با پشتیبانی از systemd ساخته شده باشد، دستور \fIcommand\fR را پیش از آنکه systemd رایانه را به حالت خواب ببرد اجرا می‌کند.\&
.PP
نکته: این ویژگی به خواب رفتن رایانه را تنها تا سقف تعیین‌شده توسط گزینهٔ InhibitDelayMaxSec در \fBlogind.\&conf(5)\fR به تعویق می‌اندازد.\& دستوری که تا آن هنگام تمام نشده باشد، پس از بازگشت از حالت خواب به اجرای خود ادامه خواهد داد.\&
.PP
.RE
\fBafter-resume\fR <command>
.RS 4
اگر همراه با پشتیبانی از systemd ساخته شده باشد، دستور \fIcommand\fR را پس از آنکه logind سیگنال بازگشت رایانه از خواب را ارسال کرد اجرا می‌کند.\&
.PP
.RE
\fBlock\fR <command>
.RS 4
اگر همراه با پشتیبانی از systemd ساخته شده باشد، هنگامی که logind سیگنال قفل شدن نشست (session) را ارسال کند، دستور \fIcommand\fR را اجرا می‌کند.\&
.PP
.RE
\fBunlock\fR <command>
.RS 4
اگر همراه با پشتیبانی از systemd ساخته شده باشد، هنگامی که logind سیگنال باز شدن قفل نشست (session) را ارسال کند، دستور \fIcommand\fR را اجرا می‌کند.\&
.PP
.RE
\fBidlehint\fR <timeout>
.RS 4
اگر همراه با پشتیبانی از systemd ساخته شده باشد، مقدار IdleHint را پس از <timeout> ثانیه به گونه‌ای تنظیم می‌کند که نشان‌دهندهٔ یک نشست بیکار در logind/elogind باشد.\& افزودن یک رویداد idlehint همچنین باعث می‌شود swayidle در هنگام اجرا، بازگشت به کار، باز شدن قفل و غیره SetIdleHint(false) را فراخوانی کند.\&
.PP
.RE
تمامی دستورها در یک پوسته (shell) اجرا می‌شوند.\&
.PP
.SH "سیگنال‌ها (SIGNALS)"
.PP
برنامهٔ swayidle به سیگنال‌های زیر پاسخ می‌دهد:
.PP
\fBSIGTERM, SIGINT\fR
.RS 4
تمام دستورهای معوقهٔ resume را اجرا می‌کند.\& پس از پایان، swayidle خاتمه می‌یابد.\&
.PP
.RE
\fBSIGUSR1\fR
.RS 4
بلافاصله وارد وضعیت بیکاری (idle) می‌شود.\&
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
swayidle -w \
	timeout 300 \'swaylock -f -c 000000\' \
	timeout 600 \'swaymsg "output * power off"\' \
		resume \'swaymsg "output * power on"\' \
	before-sleep \'swaylock -f -c 000000\'
.fi
.RE
.PP
این دستور پس از ۳۰۰ ثانیه عدم فعالیت، صفحهٔ شما را قفل می‌کند، سپس با گذشت ۳۰۰ ثانیه دیگر نمایشگرها را خاموش می‌کند، و در صورت بازگشت فعالیت، صفحه‌نمایش‌ها را دوباره روشن می‌سازد.\& همچنین پیش از رفتن رایانه به حالت خواب، صفحهٔ شما را قفل خواهد کرد.\&
.PP
برای اطمینان از این‌که swayidle پیش از آزادسازی قفل مهار (inhibition lock) منتظر می‌ماند تا swaylock صفحه را قفل کند، از گزینهٔ \fB-w\fR در swayidle و گزینهٔ \fB-f\fR در swaylock استفاده شده است.\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نگه‌داری‌شده توسط Drew DeVault <sir@cmpwn.\&com> با همراهی سایر مشارکت‌کنندگان متن‌باز.\& برای اطلاعات بیشتر دربارهٔ توسعهٔ swayidle، به <https://github.com/swaywm/swayidle> مراجعه کنید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsway\fR(5) \fBswaymsg\fR(1) \fBsway-input\fR(5) \fBsway-output\fR(5) \fBsway-bar\fR(5) \fBloginctl\fR(1)