NOTIFY-SEND(1) User Commands NOTIFY-SEND(1)

notify-send - ابزاری برای ارسال اعلان‌های میزکار

notify-send [OPTIONS] {summary} [body]

با استفاده از notify-send می‌توانید از طریق خط فرمان و به واسطه یک دیمن اعلان (notification daemon)، اعلان‌های میزکار را برای کاربر ارسال کنید. این اعلان‌ها می‌توانند برای باخبر کردن کاربر از یک رویداد یا نمایش اطلاعات، بدون ایجاد مزاحمت در کار او، استفاده شوند.

-?, --help

نمایش راهنما و خروج.

-a, --app-name=APP_NAME

نام برنامه را برای اعلان مشخص می‌کند.

-A, --action=[NAME=]Text...

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

--selected-action-fd=FILE_DESCRIPTOR

توصیف‌کننده فایلی (file descriptor) که عملیات انتخاب‌شده توسط کاربر در آن نوشته می‌شود.

--activation-token-fd=FILE_DESCRIPTOR

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

-u, --urgency=LEVEL

سطح اضطرار را مشخص می‌کند (low، normal، critical).

-t, --expire-time=TIME

مدت‌زمان (به میلی‌ثانیه) نمایش اعلان بر روی صفحه نمایش.

همه پیاده‌سازی‌ها از این پارامتر استفاده نمی‌کنند. GNOME Shell و Notify OSD همیشه آن را نادیده می‌گیرند، در حالی که Plasma آن را برای اعلان‌هایی با سطح اضطرار critical نادیده می‌گیرد.

-i, --icon=ICON

نام فایل یک آیکون یا یک آیکون استاندارد را برای نمایش مشخص می‌کند.

-n, --app-icon=ICON

نام فایل آیکون برنامه یا نام آیکون برنامه را مشخص می‌کند. سرور ممکن است آن را نمایش دهد یا ندهد.

-c, --category=TYPE[,TYPE...]

دسته‌بندی اعلان را مشخص می‌کند.

-h, --hint=TYPE:NAME:VALUE

داده‌های اضافی اولیه‌ای را برای ارسال مشخص می‌کند. انواع معتبر عبارتند از: BOOLEAN، INT، DOUBLE، STRING، BYTE و VARIANT.

-p, --print-id

شناسه (ID) اعلان را چاپ می‌کند.

--id-fd=FILE_DESCRIPTOR

توصیف‌کننده فایلی که شناسه اعلان در آن نوشته می‌شود.

-r, --replace-id=REPLACE_ID

شناسه اعلانی که باید جایگزین شود.

-w, --wait

پیش از خروج، تا زمان بسته شدن اعلان منتظر می‌ماند. اگر expire-time تنظیم شده باشد، به عنوان حداکثر زمان انتظار استفاده خواهد شد.

-e, --transient

یک اعلان گذرا (transient) را نشان می‌دهد. اعلان‌های گذرا قابلیت ماندگاری کارساز (server persistence) را در صورت وجود دور می‌زنند؛ بنابراین تا زمانی که کاربر آن را تأیید کند، ذخیره نخواهند شد.

مشخصات اعلان‌های میزکار (Desktop Notification Spec) در https://specifications.freedesktop.org/notification-spec.

Andre Filipe de Assuncao e Brito <decko@noisemakers.org>

نویسنده اصلی

Paul van Tilburg <paulvt@debian.org>

نویسنده اصلی

Riccardo Setti <giskard@debian.org>

نویسنده اصلی
libnotify