| dunstctl(1) | مرجع Dunstctl | dunstctl(1) |
نام (NAME)
dunstctl - ابزار خط فرمان برای کنترل و مدیریت dunst
خلاصه دستور (SYNOPSIS)
dunstctl COMMAND [PARAMETER]
دستورها (COMMANDS)
- action notification_position
- عملیات پیش‌فرض را اجرا می‌کند یا اگر موجود نباشد، منوی زمینه (Context Menu) اعلان را در موقعیت داده‌شده باز می‌کند (شمارش از بالا شروع می‌شود و اولین اعلان ۰ است).
- close [ID]
- بالاترین اعلانی را که در حال حاضر نمایش داده می‌شود می‌بندد. می‌توانید به صورت اختیاری یک شناسه (ID) برای بستن اعلان منطبق ارسال کنید (در صورت وجود).
- close-all
- تمام اعلان‌هایی را که در حال حاضر نمایش داده می‌شوند می‌بندد.
- context
- منوی زمینه را باز می‌کند و تمام عملیات و پیوندهای اینترنتی (URL) موجود برای اعلان‌های باز فعلی را نمایش می‌دهد.
- count [displayed/history/waiting]
- تعداد اعلان‌های نمایش‌داده‌شده، در تاریخچه و در حال انتظار را برمی‌گرداند. اگر هیچ آرگومانی ارائه نشود، تمام اطلاعات چاپ خواهند شد.
- history
- تاریخچه اعلان‌ها را در قالب JSON صادر می‌کند.
- history-clear
- تمام اعلان‌ها را از تاریخچه حذف می‌کند.
- history-pop [ID]
- اعلانی را که اخیراً بسته شده است دوباره نمایش می‌دهد. این دستور را می‌توان چندین بار فراخوانی کرد تا اعلان‌های قدیمی‌تر تا سقف محدودیت تاریخچه پیکربندی‌شده در dunst نمایش داده شوند. می‌توانید به صورت اختیاری یک شناسه به history-pop بدهید که در این صورت اعلان با شناسه داده‌شده نمایش داده می‌شود.
- history-rm ID
- اعلان با شناسه (ID) داده‌شده را از تاریخچه حذف می‌کند.
- is-paused
- بررسی می‌کند که آیا dunst در حال اجراست یا متوقف (pause) شده است. اگر dunst متوقف شده باشد، اعلان‌ها نگهداری می‌شوند اما تا زمان خروج از توقف نمایش داده نمی‌شوند.
- set-paused true/false/toggle
- وضعیت توقف dunst را تنظیم می‌کند. اگر مقدار false باشد، dunst به طور عادی اجرا می‌شود؛ اگر true باشد، dunst متوقف می‌شود (با حداکثر سطح توقف ۱۰۰). برای اطلاعات بیشتر به دستور is-paused و صفحه راهنمای dunst مراجعه کنید.
- get-pause-level
- سطح توقف
فعلی dunst را
دریافت
می‌کند، که
در آن ۰ به
معنی عدم
توقف و ۱۰۰
به معنی
توقف کامل
است.
این دستور می‌تواند با ویژگی override_pause_level اعلان ترکیب شود تا اعلان‌های خاص به صورت انتخابی در زمان توقف نمایش داده شوند.
- set-pause-level [level]
- سطح توقف را
تنظیم
می‌کند، که
در آن ۰ به
معنی عدم
توقف و ۱۰۰
به معنی
حداکثر
توقف است.
این گزینه می‌تواند با ویژگی override_pause_level اعلان ترکیب شود تا اعلان‌های خاص به صورت انتخابی در زمان توقف نمایش داده شوند.
- rule rule_name enable/disable/toggle
- قاعده مشخص‌شده با نام آن را فعال، غیرفعال یا وضعیت آن را جابه‌جا (toggle) می‌کند. این گزینه می‌تواند برای فعال‌سازی یا غیرفعال‌سازی موقت قواعد خاص استفاده شود.
- rules [--json]
- تمام قواعد پیکربندی‌شده فعلی را صادر می‌کند (به صورت اختیاری با قالب‌بندی JSON).
- reload [dunstrc ...]
- تنظیمات نمونه در حال اجرای dunst را مجدداً بارگذاری می‌کند. می‌توانید به صورت اختیاری مشخص کنید که کدام فایل‌های پیکربندی استفاده شوند؛ در غیر این صورت، پیکربندی مشخص‌شده در اولین فراخوانی dunst مجدداً بارگذاری خواهد شد. هنگامی که dunst مجدداً بارگذاری می‌شود، تمام قواعد دوباره بر روی اعلان اصلی اعمال می‌شوند، بنابراین تغییرات ایجادشده توسط قواعد قبلی در نظر گرفته نمی‌شوند.
- debug
- سعی می‌کند با dunst ارتباط برقرار کند و خطاهای رایج بین dunstctl و dunst را بررسی می‌کند. اگر چیزی درست کار نمی‌کند بسیار کاربردی است.
- help
- تمام دستورهای موجود را به همراه توضیحی کوتاه نمایش می‌دهد.
حق نشر (COPYRIGHT)
حق نشر 2011-2014 متعلق به Sascha Kruse
حق نشر 2014-2026 متعلق به مشارکت‌کنندگان Dunst
نرم‌افزار Dunst تحت مجوز BSD 3-Clause منتشر شده است؛ برای اطلاعات بیشتر به فایل LICENSE مراجعه کنید.
اگر احساس می‌کنید حق نشری نقض شده است، لطفاً به نگهدارندگان ایمیل بفرستید.
همچنین ببینید (SEE ALSO)
| 2026-08-10 | 1.13.2 (2026-03-18) |