.\" -*- 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 "dunst 1"
.TH dunst 1 2026-08-10 "1.13.2 (2026-03-18)" "Dunst Reference"
.\" 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)"
dunst \- دیمن اعلان سبک و با قابلیت سفارشی‌سازی بالا
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
dunst [\-\-config FILE] [\-\-verbosity v] [\-\-print] [\-\-startup_notification]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
dunst یک دیمن اعلان بسیار سبک و با قابلیت پیکربندی و سفارشی‌سازی بالا است.
.SS "راه‌اندازی خودکار dunst (Autostarting dunst)"
.IX Subsection "Autostarting dunst"
در بیشتر نصب‌ها، dunst باید بتواند هنگام ارسال یک اعلان، به‌طور خودکار توسط D\-Bus راه‌اندازی شود. در صورتی که چند دیمن اعلان نصب شده باشد این روش توصیه نمی‌شود، زیرا D\-Bus نخواهد دانست کدام‌یک را باید اجرا کند.
روش‌های دیگر برای راه‌اندازی خودکار dunst شامل اجرای آن همراه با قابلیت راه‌اندازی خودکار محیط رومیزی یا مدیر پنجره، یا از طریق سرویس ارائه‌شده systemd است.
.SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)"
.IX Header "COMMAND LINE OPTIONS"
.IP \fB\-h/\-help/\-\-help\fR 4
.IX Item "-h/-help/--help"
فهرست کردن تمام پرچم‌ها و گزینه‌های خط فرمان.
.IP "\fB\-conf/\-config/\-\-config FILE\fR" 4
.IX Item "-conf/-config/--config FILE"
استفاده از فایل پیکربندی جایگزین.
این گزینه جستجو برای سایر فایل‌های پیکربندی را غیرفعال می‌کند.
اگر باز کردن فایل امکان‌پذیر نباشد، dunst یک هشدار صادر کرده و به مقادیر پیش‌فرض داخلی خود بازمی‌گردد.
(نکته: دستور \`dunst \-conf \- </dev/null\` می‌تواند برای اعمال اجباری مقادیر پیش‌فرض، مثلاً برای آزمایش، استفاده شود).
.IP \fB\-v/\-version/\-\-version\fR 4
.IX Item "-v/-version/--version"
چاپ اطلاعات نسخه.
.IP "\fB\-verbosity/\-\-verbosity\fR (values: \*(Aqcrit\*(Aq, \*(Aqwarn\*(Aq, \*(Aqmesg\*(Aq, \*(Aqinfo\*(Aq, \*(Aqdebug\*(Aq default \*(Aqmesg\*(Aq)" 4
.IX Item "-verbosity/--verbosity (values: 'crit', 'warn', 'mesg', 'info', 'debug' default 'mesg')"
پیام‌های گزارشی (log) را که اولویت کمتری نسبت به سطح پرگویی (verbosity) مشخص‌شده دارند نمایش نمی‌دهد. این گزینه بر چاپ اعلان‌ها در ترمینال تأثیری نخواهد داشت؛ برای این منظور از گزینه \*(Aq\-print\*(Aq استفاده کنید.
.IP \fB\-print/\-\-print\fR 4
.IX Item "-print/--print"
چاپ اعلان‌ها در خروجی استاندارد (stdout). این گزینه می‌تواند برای ثبت گزارش، تنظیم قواعد یا استفاده از خروجی در سایر اسکریپت‌ها مفید باشد.
.IP \fB\-startup_notification/\-\-startup_notification\fR 4
.IX Item "-startup_notification/--startup_notification"
نمایش یک اعلان هنگام راه‌اندازی برنامه.
.SH "پیکربندی (CONFIGURATION)"
.IX Header "CONFIGURATION"
یک فایل پیکربندی پیش‌فرض همراه بسته ارائه شده است (معمولاً در مسیر /etc/dunst/dunstrc) و به عنوان کم‌اهمیت‌ترین فایل پیکربندی عمل می‌کند. توجه: این فایل قبلاً در مسیر /usr/share/dunst/dunstrc قرار داشت. می‌توانید این فایل را برای تغییر تنظیمات پیش‌فرض سراسری سیستم ویرایش کنید یا آن را در مکانی با اولویت بالاتر کپی کنید تا تنظیمات آن را بازنویسی کند. برای جزئیات بیشتر درباره مکان‌هایی که dunst به دنبال فایل‌های پیکربندی خود می‌گردد و نحوه اعمال تنظیمات، بخش فایل‌ها (FILES) را ببینید.
.PP
برای مشاهده تمام تنظیمات ممکن، به \fBdunst\fR\|(5) مراجعه کنید.
.SS "سرنخ‌های notify\-send (NOTIFY\-SEND HINTS)"
.IX Subsection "NOTIFY-SEND HINTS"
برنامه dunst می‌تواند از طریق notify\-send رنگ‌های متفاوتی را برای یک پیام دریافت کند.
برای انجام این کار باید با استفاده از گزینه \-h یک سرنخ (hint) اضافه کنید.
مقدار پیشرفت (progress) نیز می‌تواند با یک سرنخ تنظیم شود.
.PP
برای مشاهده فهرست سرنخ‌های پذیرفته‌شده به \fBdunst\fR\|(5) مراجعه کنید.
.PP
چند مثال:
.PP
.Vb 1
\&    notify\-send \-h string:fgcolor:#ff4444
\&
\&    notify\-send \-h string:bgcolor:#4444ff \-h string:fgcolor:#ff4444 \-h string:frcolor:#44ff44
\&
\&    notify\-send \-h int:value:42 "Working ..."
.Ve
.SH "متفرقه (MISCELLANEOUS)"
.IX Header "MISCELLANEOUS"
اجرای dunst را می‌توان با دستور \`dunstctl set\-paused true\` موقتاً متوقف کرد (مکث). برای از سرگیری اجرای dunst از دستور \`dunstctl set\-paused false\` استفاده کنید.
روش دیگر، ارسال سیگنال‌های SIGUSR1 و SIGUSR2 به ترتیب برای مکث و از سرگیری است. متوقف کردن موقت با استفاده از dunstctl نسبت به استفاده از سیگنال‌ها ترجیح داده می‌شود، زیرا معنای سیگنال‌ها پایدار نبوده و ممکن است در آینده تغییر کند.
.PP
هنگامی که dunst در حالت مکث قرار دارد، هیچ اعلانی را نمایش نمی‌دهد، اما تمام اعلان‌ها را در یک صف نگه می‌دارد. به عنوان مثال می‌توان از این قابلیت همراه با قفل‌کننده‌های صفحه نمایش (مانند i3lock یا slock) استفاده کرد تا از نمایان شدن اعلان‌ها از پشت صفحه قفل جلوگیری شود و پس از بازگشت به رایانه بتوان تمام اعلان‌های از دست‌رفته را مرور کرد.
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
این‌ها دایرکتوری‌های پایه‌ای هستند که dunst در آن‌ها به ترتیب \fIاهمیت نزولی\fR به دنبال فایل‌های پیکربندی می‌گردد:
.ie n .IP $XDG_CONFIG_HOME 8
.el .IP \f(CW$XDG_CONFIG_HOME\fR 8
.IX Item "$XDG_CONFIG_HOME"
این دایرکتوری بالاترین اهمیت را دارد (اگر خالی باشد یا تنظیم نشده باشد، مسیر پیش‌فرض \f(CW\*(C`$HOME/.config\*(C'\fR خواهد بود).
.ie n .IP $XDG_CONFIG_DIRS 8
.el .IP \f(CW$XDG_CONFIG_DIRS\fR 8
.IX Item "$XDG_CONFIG_DIRS"
این متغیر، مشابه متغیر \f(CW$PATH\fR، فهرستی از دایرکتوری‌های پایه جداشده با دو‌نقطه (:) به ترتیب \fIاهمیت نزولی\fR است.
(اگر خالی باشد یا تنظیم نشده باشد، مسیر پیش‌فرض \fI/etc\fR خواهد بود).
.PP
برنامه dunst این دایرکتوری‌ها را برای مسیرهای نسبی زیر جستجو می‌کند:
.IP \fIdunst/dunstrc\fR 8
.IX Item "dunst/dunstrc"
این فایل، پیکربندی پایه است و از این رو کم‌اهمیت‌ترین فایل در یک دایرکتوری پایه معین به شمار می‌آید.
.IP \fIdunst/dunstrc.d/*.conf\fR 8
.IX Item "dunst/dunstrc.d/*.conf"
این‌ها فایل‌های تکمیلی («drop\-in») هستند (به پسوند «.d» در نام دایرکتوری دقت کنید).
این فایل‌ها نسبت به dunstrc پایه در دایرکتوری والد اولویت بیشتری دارند، زیرا به عنوان قطعه‌های پیکربندی کوچک برای بازنویسی تنظیمات در نظر گرفته می‌شوند.
آخرین فایل بر اساس ترتیب الفبایی بالاترین اهمیت را دارد، بنابراین می‌توانید به سادگی با تغییر نام آن‌ها اولویت‌شان را عوض کنید.
روشی معمول برای نام‌گذاری این فایل‌ها، افزودن یک پیشوند عددی به نام آن‌هاست، به عنوان نمونه:
.Sp
.Vb 4
\&    00\-least\-important.conf
\&    01\-foo.conf
\&    20\-bar.conf
\&    99\-most\-important.conf
.Ve
.Sp
تنها فایل‌های دارای پسوند \fB.conf\fR خوانده خواهند شد.
.PP
تنها تنظیمات آخرین پیکربندی پایه و فایل‌های تکمیلی متناظر با آن اعمال می‌شوند.
بنابراین اگر یک dunstrc ابتدا در \fI~/.config/dunst/dunstrc\fR پیدا شود، فایل‌های تکمیلی در مسیر \fI~/.config/dunst/dunstrc.d/*\fR جستجو خواهند شد. تنظیمات موجود در فایل‌های بااهمیت‌تر، مقادیر موجود در فایل‌های کم‌اهمیت‌تر را بازنویسی می‌کنند.
.PP
اگر می‌خواهید پیکربندی را به‌صورت پویا تغییر دهید، می‌توانید به سادگی از دستور \fBdunstctl reload\fR برای بارگذاری مجدد فایل‌های تغییریافته استفاده کنید. برای اطلاعات بیشتر به \fBdunst\fR\|(5) مراجعه کنید.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.IX Header "REPORTING BUGS"
ایرادات و پیشنهادها باید در گیت‌هاب در نشانی <https://github.com/dunst\-project/dunst/issues> گزارش شوند.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright 2011\-2014 Sascha Kruse
.PP
Copyright 2014\-2026 Dunst contributors
.PP
Dunst تحت مجوز BSD 3\-Clause منتشر شده است؛ برای اطلاعات بیشتر فایل LICENSE را ببینید.
.PP
اگر احساس می‌کنید کپی‌رایت نقض شده است، لطفاً به نگهدارندگان ایمیل بفرستید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdunst\fR\|(5), \fBdunstctl\fR\|(1), \fBdmenu\fR\|(1), \fBnotify\-send\fR\|(1), \fBdunstify\fR\|(1)