kitten-notify(1)                     kitty                    kitten-notify(1)

نام (NAME)
       kitten-notify - ارسال اعلان‌های دسکتاپ از درون ترمینال kitty

نمای کلی (OVERVIEW)
       نمایش اعلان‌های بالاپران (پاپ‌آپ) سیستم.

       اضافه‌شده در نسخه 0.36.0: کیتن notify


       کیتن notify می‌تواند برای نمایش اعلان‌های بالاپران سیستمی از درون شل
       استفاده شود. این قابلیت حتی از طریق SSH نیز کار می‌کند. استفاده از آن
       بسیار ساده است:

          kitten notify "Good morning" Hello world, it is a nice day!

       برای افزودن آیکون:

          kitten notify --icon-path /path/to/some/image.png "Good morning" Hello world, it is a nice day!
          kitten notify --icon firefox "Good morning" Hello world, it is a nice day!

       برای آگاهی از فعال شدن یا کلیک روی اعلان:

          kitten notify --wait-for-completion "Good morning" Hello world, it is a nice day!

       سپس کیتن منتظر می‌ماند تا اعلان بسته شود یا کاربر روی آن کلیک کند.  در
       صورت فعال شدن، مقدار 0 در STDOUT چاپ می‌شود. می‌توانید کلیدهای Esc یا
       Ctrl+c را برای لغو و بستن اعلان فشار دهید.

       برای افزودن دکمه‌ها به اعلان:

          kitten notify --wait-for-completion --button One --button Two "Good morning" Hello world, it is a nice day!

       نکته:
          درباره پروتکل کدهای گریز (escape code) اعلان‌های دسکتاپ بیشتر
          بیاموزید.

کد منبع notify (Source code for notify)
       کد منبع این کیتن در گیت‌هاب در دسترس است:
       <https://github.com/kovidgoyal/kitty/tree/master/kittens/notify>.

رابط خط فرمان (Command line interface)

          kitten notify [options] TITLE [BODY ...]

       ارسال اعلان به کاربر که از طریق سرویس اعلان‌های محیط رومیزی نمایش داده
       می‌شود. از طریق SSH نیز کار می‌کند.

       برای به‌روزرسانی یک اعلان موجود، شناسه اعلان را با گزینه --identifier
       مشخص کنید. مقدار آن باید همان شناسه‌ای باشد که برای اعلانی که قصد
       به‌روزرسانی‌اش را دارید تعیین کرده بودید.

       اگر عنوانی مشخص نشود و یک شناسه با گزینه --identifier تعیین شده باشد،
       به جای ایجاد اعلان جدید، اعلان موجود دارای شناسه مشخص‌شده بسته می‌شود.

   گزینه‌ها (Options)

       --icon <ICON>, -n <ICON>
              نام آیکون مورد استفاده برای اعلان. آیکونی با این نام در رایانه
              اجراکننده شبیه‌ساز ترمینال جستجو خواهد شد. می‌تواند چندین بار مشخص
              شود و نخستین نام یافت‌شده استفاده می‌شود. نام‌های استاندارد: error,
              file-manager, help, info, question, system-monitor, text-editor,
              warn, warning

       --icon-path <ICON_PATH>, -p <ICON_PATH>
              مسیر یک فایل تصویری در قالب‌های PNG/JPEG/GIF برای استفاده به
              عنوان آیکون. اگر هم نام و هم مسیر مشخص شده باشند، ابتدا نام
              جستجو می‌شود و در صورت نیافتن، از مسیر استفاده خواهد شد.

       --app-name <APP_NAME>, -a <APP_NAME>
              نام برنامه برای اعلان.  پیش‌فرض: kitten-notify

       --button <BUTTON>, -b <BUTTON>
              افزودن دکمه‌ای با متن مشخص‌شده به اعلان. برای افزودن چندین دکمه
              می‌تواند چندین بار تکرار شود. اگر از --wait-till-closed استفاده
              شود، در صورت کلیک کاربر روی یک دکمه، کیتن شماره آن دکمه را در
              STDOUT چاپ می‌کند؛ 1 برای نخستین دکمه، 2 برای دومین دکمه و به
              همین ترتیب.

       --urgency <URGENCY>, -u <URGENCY>
              میزان فوریت اعلان.  پیش‌فرض: normal انتخاب‌ها: critical, low,
              normal

       --expire-after <EXPIRE_AFTER>, -e <EXPIRE_AFTER>
              مدت زمانی که اعلان روی صفحه نمایش داده می‌شود. حالت پیش‌فرض
              استفاده از سیاست سرویس اعلان‌های سیستم‌عامل است. مقدار never به
              این معنی است که اعلان هرگز منقضی نمی‌شود، اگرچه بسته به سیاست‌های
              سرویس اعلان سیستم‌عامل ممکن است کار کند یا نکند. زمان در قالب
              NUMBER[SUFFIX] مشخص می‌شود که در آن SUFFIX می‌تواند s برای ثانیه،
              m برای دقیقه، h برای ساعت یا d برای روز باشد. مقادیر غیرصحیح
              مجاز هستند. در صورت عدم تعیین، ثانیه فرض می‌شود. بسته شدن خودکار
              اعلان پس از سپری شدن زمان مشخص‌شده تضمین شده است. اعلان ممکن است
              پیش از آن توسط اقدام کاربر یا سیاست سیستم‌عامل بسته شود.

       --sound-name <SOUND_NAME>, -s <SOUND_NAME>
              نام صدایی که همراه با اعلان پخش می‌شود. system به معنای اجازه
              دادن به سیستم اعلان برای استفاده از هر صدای دلخواه است. silent
              از پخش هرگونه صدایی جلوگیری می‌کند. هر مقدار دیگری به سیستم اعلان
              دسکتاپ ارسال می‌شود که ممکن است آن را اعمال کند یا نکند.  پیش‌فرض:
              system

       --type <TYPE>, -t <TYPE>
              نوع اعلان. می‌تواند هر رشته‌ای باشد و توسط کاربران برای ایجاد
              قوانین فیلتر اعلان‌ها استفاده می‌شود؛ بنابراین عبارتی متناسب با
              هدف اعلان انتخاب کنید.

       --identifier <IDENTIFIER>, -i <IDENTIFIER>
              شناسه این اعلان. اگر اعلانی با همین شناسه در حال حاضر نمایش داده
              شده باشد، جایگزین/به‌روزرسانی می‌شود.

       --print-identifier [=no], -P [=no]
              چاپ شناسه اعلان در STDOUT. هنگام عدم تعیین شناسه دلخواه با گزینه
              --identifier مفید است.

       --wait-for-completion [=no], --wait-till-closed [=no], -w [=no]
              انتظار تا بسته شدن اعلان. اگر کاربر اعلان را فعال کند (روی آن
              کلیک کند)، پیش از خروج مقدار "0" در STDOUT چاپ می‌شود. اگر دکمه‌ای
              روی اعلان فشرده شود، شماره متناظر با آن دکمه در STDOUT چاپ خواهد
              شد. برای بستن دستی اعلان کلیدهای Esc یا Ctrl+C را فشار دهید.

       --only-print-escape-code [=no]
              تنها چاپ کد گریز (escape code) در STDOUT. در صورتی که از این
              کیتن به عنوان بخشی از یک برنامه بزرگ‌تر استفاده می‌کنید کاربردی
              است. اگر این گزینه مشخص شود، از گزینه --wait-till-closed برای
              تولید کد گریز استفاده خواهد شد، اما انتظار واقعی انجام نخواهد
              گرفت.

       --icon-cache-id <ICON_CACHE_ID>, -g <ICON_CACHE_ID>
              شناسه مورد استفاده هنگام کش کردن آیکون‌ها در شبیه‌ساز ترمینال.
              استفاده از شناسه بدین معناست که داده‌های آیکون تنها یک‌بار با
              استفاده از --icon-path ارسال می‌شوند. فراخوانی‌های بعدی دست‌کم تا
              زمان راه‌اندازی مجدد ترمینال از داده‌های کش‌شده آیکون استفاده
              خواهند کرد. این قابلیت هنگام استفاده از این کیتن در یک برنامه
              بزرگ‌تر همراه با --only-print-escape-code بسیار کاربردی است.

نویسنده (AUTHOR)
       Kovid Goyal

حق نشر (COPYRIGHT)
       2026, Kovid Goyal

0.48.2                           July 30, 2026                kitten-notify(1)