.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "dunstctl 1"
.TH dunstctl 1 2026-08-10 "1.13.2 (2026-03-18)" "مرجع Dunstctl"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
dunstctl \- ابزار خط فرمان برای کنترل و مدیریت dunst
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
dunstctl COMMAND [PARAMETER]
.SH "دستورها (COMMANDS)"
.IX Header "COMMANDS"
.IP "\fBaction\fR notification_position" 4
.IX Item "action notification_position"
عملیات پیش‌فرض را اجرا می‌کند یا اگر موجود نباشد، منوی زمینه (Context Menu) اعلان را در موقعیت داده‌شده باز می‌کند (شمارش از بالا شروع می‌شود و اولین اعلان ۰ است).
.IP "\fBclose\fR [ID]" 4
.IX Item "close [ID]"
بالاترین اعلانی را که در حال حاضر نمایش داده می‌شود می‌بندد.
می‌توانید به صورت اختیاری یک شناسه (ID) برای بستن اعلان منطبق ارسال کنید (در صورت وجود).
.IP \fBclose\-all\fR 4
.IX Item "close-all"
تمام اعلان‌هایی را که در حال حاضر نمایش داده می‌شوند می‌بندد.
.IP \fBcontext\fR 4
.IX Item "context"
منوی زمینه را باز می‌کند و تمام عملیات و پیوندهای اینترنتی (URL) موجود برای اعلان‌های باز فعلی را نمایش می‌دهد.
.IP "\fBcount\fR [displayed/history/waiting]" 4
.IX Item "count [displayed/history/waiting]"
تعداد اعلان‌های نمایش‌داده‌شده، در تاریخچه و در حال انتظار را برمی‌گرداند. اگر هیچ آرگومانی ارائه نشود، تمام اطلاعات چاپ خواهند شد.
.IP \fBhistory\fR 4
.IX Item "history"
تاریخچه اعلان‌ها را در قالب JSON صادر می‌کند.
.IP \fBhistory\-clear\fR 4
.IX Item "history-clear"
تمام اعلان‌ها را از تاریخچه حذف می‌کند.
.IP "\fBhistory\-pop\fR [ID]" 4
.IX Item "history-pop [ID]"
اعلانی را که اخیراً بسته شده است دوباره نمایش می‌دهد. این دستور را می‌توان چندین بار فراخوانی کرد تا اعلان‌های قدیمی‌تر تا سقف محدودیت تاریخچه پیکربندی‌شده در dunst نمایش داده شوند. می‌توانید به صورت اختیاری یک شناسه به \fBhistory\-pop\fR بدهید که در این صورت اعلان با شناسه داده‌شده نمایش داده می‌شود.
.IP "\fBhistory\-rm\fR ID" 4
.IX Item "history-rm ID"
اعلان با شناسه (ID) داده‌شده را از تاریخچه حذف می‌کند.
.IP \fBis\-paused\fR 4
.IX Item "is-paused"
بررسی می‌کند که آیا dunst در حال اجراست یا متوقف (pause) شده است. اگر dunst متوقف شده باشد، اعلان‌ها نگهداری می‌شوند اما تا زمان خروج از توقف نمایش داده نمی‌شوند.
.IP "\fBset\-paused\fR true/false/toggle" 4
.IX Item "set-paused true/false/toggle"
وضعیت توقف dunst را تنظیم می‌کند. اگر مقدار \fBfalse\fR باشد، dunst به طور عادی اجرا می‌شود؛ اگر \fBtrue\fR باشد، dunst متوقف می‌شود (با حداکثر سطح توقف ۱۰۰).
برای اطلاعات بیشتر به دستور \fBis\-paused\fR و صفحه راهنمای dunst مراجعه کنید.
.IP \fBget\-pause\-level\fR 4
.IX Item "get-pause-level"
سطح توقف فعلی dunst را دریافت می‌کند، که در آن ۰ به معنی عدم توقف و ۱۰۰ به معنی توقف کامل است.
.Sp
این دستور می‌تواند با ویژگی \fBoverride_pause_level\fR اعلان ترکیب شود تا اعلان‌های خاص به صورت انتخابی در زمان توقف نمایش داده شوند.
.IP "\fBset\-pause\-level\fR [level]" 4
.IX Item "set-pause-level [level]"
سطح توقف را تنظیم می‌کند، که در آن ۰ به معنی عدم توقف و ۱۰۰ به معنی حداکثر توقف است.
.Sp
این گزینه می‌تواند با ویژگی \fBoverride_pause_level\fR اعلان ترکیب شود تا اعلان‌های خاص به صورت انتخابی در زمان توقف نمایش داده شوند.
.IP "\fBrule\fR rule_name enable/disable/toggle" 4
.IX Item "rule rule_name enable/disable/toggle"
قاعده مشخص‌شده با نام آن را فعال، غیرفعال یا وضعیت آن را جابه‌جا (toggle) می‌کند. این گزینه می‌تواند برای فعال‌سازی یا غیرفعال‌سازی موقت قواعد خاص استفاده شود.
.IP "\fBrules\fR [\-\-json]" 4
.IX Item "rules [--json]"
تمام قواعد پیکربندی‌شده فعلی را صادر می‌کند (به صورت اختیاری با قالب‌بندی JSON).
.IP "\fBreload\fR [dunstrc ...]" 4
.IX Item "reload [dunstrc ...]"
تنظیمات نمونه در حال اجرای dunst را مجدداً بارگذاری می‌کند. می‌توانید به صورت اختیاری مشخص کنید که کدام فایل‌های پیکربندی استفاده شوند؛ در غیر این صورت، پیکربندی مشخص‌شده در اولین فراخوانی dunst مجدداً بارگذاری خواهد شد.
هنگامی که dunst مجدداً بارگذاری می‌شود، تمام قواعد دوباره بر روی اعلان اصلی اعمال می‌شوند، بنابراین تغییرات ایجادشده توسط قواعد قبلی در نظر گرفته نمی‌شوند.
.IP \fBdebug\fR 4
.IX Item "debug"
سعی می‌کند با dunst ارتباط برقرار کند و خطاهای رایج بین dunstctl و dunst را بررسی می‌کند.
اگر چیزی درست کار نمی‌کند بسیار کاربردی است.
.IP \fBhelp\fR 4
.IX Item "help"
تمام دستورهای موجود را به همراه توضیحی کوتاه نمایش می‌دهد.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر 2011\-2014 متعلق به Sascha Kruse
.PP
حق نشر 2014\-2026 متعلق به مشارکت‌کنندگان Dunst
.PP
نرم‌افزار Dunst تحت مجوز BSD 3\-Clause منتشر شده است؛ برای اطلاعات بیشتر به فایل LICENSE مراجعه کنید.
.PP
اگر احساس می‌کنید حق نشری نقض شده است، لطفاً به نگهدارندگان ایمیل بفرستید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdunst\fR\|(5), \fBdmenu\fR\|(1), \fBnotify\-send\fR\|(1), \fBdunstify\fR\|(1)