نام (NAME)

dunst - دیمن اعلان سبک و با قابلیت سفارشی‌سازی بالا

خلاصه دستور (SYNOPSIS)

dunst [--config FILE] [--verbosity v] [--print] [--startup_notification]

توضیحات (DESCRIPTION)

دانست (Dunst) یک دیمن اعلان بسیار سبک و با قابلیت پیکربندی و سفارشی‌سازی بالا است.

گزینه‌های خط فرمان (COMMAND LINE OPTIONS)

-h/-help/--help

فهرست کردن تمام پرچم‌ها و گزینه‌های خط فرمان.

-conf/-config/--config FILE

استفاده از فایل پیکربندی جایگزین. این گزینه جستجو برای سایر فایل‌های پیکربندی را غیرفعال می‌کند. اگر باز کردن فایل امکان‌پذیر نباشد، dunst یک هشدار صادر کرده و به مقادیر پیش‌فرض داخلی خود بازمی‌گردد. (نکته: دستور `dunst -conf - </dev/null` می‌تواند برای اعمال اجباری مقادیر پیش‌فرض، مثلاً برای آزمایش، استفاده شود).

-v/-version/--version

چاپ اطلاعات نسخه.

-verbosity/--verbosity (values: 'crit', 'warn', 'mesg', 'info', 'debug' default 'mesg')

پیام‌های گزارشی را که اولویت کمتری نسبت به سطح پرگویی مشخص‌شده دارند نمایش ندهد. این گزینه بر چاپ اعلان‌ها روی ترمینال تأثیری نخواهد گذاشت؛ برای چاپ اعلان‌ها از گزینه '-print' استفاده کنید.

-print/--print

چاپ اعلان‌ها در خروجی استاندارد (stdout). این گزینه می‌تواند برای ثبت گزارش، تنظیم قواعد یا استفاده از خروجی در سایر اسکریپت‌ها مفید باشد.

-startup_notification/--startup_notification

نمایش یک اعلان هنگام راه‌اندازی برنامه.

پیکربندی (CONFIGURATION)

یک فایل پیکربندی پیش‌فرض در بسته قرار داده شده است (معمولاً در مسیر /etc/dunst/dunstrc) و به عنوان کم‌اهمیت‌ترین فایل پیکربندی عمل می‌کند. توجه: این فایل قبلاً در مسیر /usr/share/dunst/dunstrc قرار داشت. می‌توانید این فایل را برای تغییر تنظیمات پیش‌فرض سراسری سیستم ویرایش کنید یا آن را در مکانی با اولویت بالاتر کپی کنید تا تنظیمات آن را بازنویسی کند. برای جزئیات بیشتر درباره محل‌هایی که dunst به دنبال فایل‌های پیکربندی خود می‌گردد و نحوه اعمال تنظیمات، بخش FILES (فایل‌ها) را ببینید.

برای مشاهده تمام تنظیمات ممکن، به dunst(5) مراجعه کنید.

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 ..."

متفرقه (MISCELLANEOUS)

اجرای dunst را می‌توان با دستور `dunstctl set-paused true` موقتاً متوقف کرد (مکث). برای از سرگیری اجرای dunst از دستور `dunstctl set-paused false` استفاده کنید. روش دیگر، ارسال سیگنال‌های SIGUSR1 و SIGUSR2 به ترتیب برای مکث و از سرگیری است. متوقف کردن موقت با استفاده از dunstctl نسبت به استفاده از سیگنال‌ها توصیه می‌شود، زیرا معنای سیگنال‌ها پایدار نیست و ممکن است در آینده تغییر کند.

هنگامی که dunst در حالت مکث است، هیچ اعلانی را نمایش نمی‌دهد، اما تمام اعلان‌ها را در یک صف نگه می‌دارد. به عنوان نمونه می‌توان از این ویژگی به همراه قفل‌کننده‌های صفحه نمایش (مانند i3lock یا slock) استفاده کرد تا از چشمک زدن اعلان‌ها از میان صفحه قفل جلوگیری شود و پس از بازگشت به رایانه بتوان تمام اعلان‌های از دست رفته را مطالعه کرد.

فایل‌ها (FILES)

این‌ها دایرکتوری‌های پایه‌ای هستند که dunst در آن‌ها به ترتیب اهمیت نزولی به دنبال فایل‌های پیکربندی می‌گردد:

$XDG_CONFIG_HOME

این دایرکتوری بالاترین اهمیت را دارد (اگر خالی باشد یا تنظیم نشده باشد، مسیر پیش‌فرض "$HOME/.config" خواهد بود).

$XDG_CONFIG_DIRS

این متغیر، مشابه متغیر $PATH، فهرستی از دایرکتوری‌های پایه جداشده با دو‌نقطه (:) به ترتیب اهمیت نزولی است. (اگر خالی باشد یا تنظیم نشده باشد، مسیر پیش‌فرض /etc خواهد بود).

برنامه dunst این دایرکتوری‌ها را برای مسیرهای نسبی فایل زیر جستجو می‌کند:

dunst/dunstrc

این فایل، پیکربندی پایه است و از این رو کم‌اهمیت‌ترین فایل در یک دایرکتوری پایه معین به شمار می‌آید.

dunst/dunstrc.d/*.conf

این‌ها فایل‌های تکمیلی («drop-in») هستند (به پسوند «.d» در نام دایرکتوری دقت کنید). این فایل‌ها نسبت به dunstrc پایه در دایرکتوری والد اولویت بیشتری دارند، زیرا قطعه‌کدهای کوچکی برای بازنویسی تنظیمات در نظر گرفته می‌شوند. آخرین فایل بر اساس ترتیب الفبایی بالاترین اهمیت را دارد، بنابراین می‌توانید به سادگی با تغییر نام آن‌ها اولویت‌شان را عوض کنید. یک روش معمول برای نام‌گذاری این فایل‌ها، افزودن یک پیشوند عددی به نام آن‌هاست، به عنوان نمونه:

00-least-important.conf
01-foo.conf
20-bar.conf
99-most-important.conf

تنها فایل‌های دارای پسوند .conf خوانده خواهند شد.

تنها تنظیمات آخرین پیکربندی پایه و فایل‌های تکمیلی متناظر با آن اعمال می‌شوند. بنابراین اگر یک dunstrc ابتدا در ~/.config/dunst/dunstrc پیدا شود، فایل‌های تکمیلی در مسیر ~/.config/dunst/dunstrc.d/* جستجو خواهند شد. تنظیمات موجود در فایل‌های بااهمیت‌تر، مقادیر موجود در فایل‌های کم‌اهمیت‌تر را بازنویسی می‌کنند.

اگر می‌خواهید پیکربندی را به‌صورت پویا تغییر دهید، می‌توانید به سادگی از دستور dunstctl reload برای بارگذاری مجدد فایل‌های تغییریافته استفاده کنید. برای اطلاعات بیشتر به dunst(5) مراجعه کنید.

گزارش باگ‌ها (REPORTING BUGS)

ایرادات و پیشنهادات را باید در گیت‌هاب در آدرس https://github.com/dunst-project/dunst/issues گزارش دهید.

حق نشر (COPYRIGHT)

Copyright 2011-2014 Sascha Kruse

Copyright 2014-2026 Dunst contributors

Dunst تحت مجوز BSD 3-Clause منتشر شده است؛ برای اطلاعات بیشتر به LICENSE مراجعه کنید.

اگر احساس می‌کنید حق نشر نقض شده است، لطفاً به نگهدارندگان ایمیل ارسال کنید.

همچنین ببینید (SEE ALSO)

dunst(5), dunstctl(1), dmenu(1), notify-send(1), dunstify(1)