mirror of
https://github.com/kovidgoyal/kitty.git
synced 2026-02-01 11:34:59 +01:00
44 lines
1.3 KiB
ReStructuredText
44 lines
1.3 KiB
ReStructuredText
notify
|
|
==================================================
|
|
|
|
.. only:: man
|
|
|
|
Overview
|
|
--------------
|
|
|
|
Show pop-up system notifications.
|
|
|
|
.. highlight:: sh
|
|
|
|
.. versionadded:: 0.36.0
|
|
The notify kitten
|
|
|
|
The ``notify`` kitten can be used to show pop-up system notifications
|
|
from the shell. It even works over SSH. Using it is as simple as::
|
|
|
|
kitten notify "Good morning" Hello world, it is a nice day!
|
|
|
|
To add an icon, use::
|
|
|
|
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!
|
|
|
|
|
|
To be informed when the notification is activated::
|
|
|
|
kitten notify --wait-for-completion "Good morning" Hello world, it is a nice day!
|
|
|
|
Then, the kitten will wait till the notification is either closed or activated.
|
|
If activated, a ``0`` is printed to :file:`STDOUT`. You can press the
|
|
:kbd:`Esc` or :kbd:`Ctrl+c` keys to abort, closing the notification.
|
|
|
|
To add buttons to the notification::
|
|
|
|
kitten notify --wait-for-completion --button One --button Two "Good morning" Hello world, it is a nice day!
|
|
|
|
.. program:: kitty +kitten notify
|
|
|
|
.. tip:: Learn about the underlying :doc:`/desktop-notifications` escape code protocol.
|
|
|
|
.. include:: /generated/cli-kitten-notify.rst
|