https://github.com/lpenz/urxvt-ext-notify-osc
urxvt OSC extension for desktop notifications
https://github.com/lpenz/urxvt-ext-notify-osc
Last synced: 2 months ago
JSON representation
urxvt OSC extension for desktop notifications
- Host: GitHub
- URL: https://github.com/lpenz/urxvt-ext-notify-osc
- Owner: lpenz
- License: mit
- Created: 2018-09-06T20:29:56.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-03-01T15:30:48.000Z (3 months ago)
- Last Synced: 2025-03-01T16:28:06.589Z (3 months ago)
- Language: CMake
- Size: 23.4 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://github.com/lpenz/urxvt-ext-notify-osc/actions/workflows/ci.yml)
[](https://packagecloud.io/app/lpenz/debian/search?q=urxvt-ext-notify-osc)
urxvt-ext-notify-osc
====================
urxvt-ext-notify-osc is a urxvt OSC extension for desktop
notifications.
In essence, this means that whenever a process prints a string like
the following:
```shell
printf '\e]777;notify;alert user;the tea is ready\a'
```
urxvt creates a desktop notification with *alert notification* as
summary and *the tea is ready* as the body. The terminal window also
get its urgency hint set, which makes the window manager call your
attention to it.
This works well even when a remote program in an ssh session prints
the string. There is no dependency on X forwarding.
## Installation
### Manual installation
#### Requirements
- *notify-send* is used to create the notifications. It lives
in the *libnotify-bin* Debian package.
- *xseturgent* is used to set the urgent hint. You can find in source
form in [github](https://github.com/lpenz/xseturgent), or as a
Debian package/repository
in [packagecloud](https://packagecloud.io/lpenz/lpenz).
(disclaimer: I'm the author)
If one of these utilities is not present, the corresponding feature
doesn't work.
#### Installing
Copy the *notify-osc* file to `~/.urxvt/ext`.
### Debian package
You can find a debian package
in [my packagecloud repository](https://packagecloud.io/lpenz/lpenz).
This options gets the dependencies sorted automatically.
### Enabling
Add *notify-osc* to the list of enabled urxvt extensions in `~/.Xresources`:
```
URxvt.perl-ext-common: ...,notify-osc
```
Reload the resources after editing that file by running:
```shell
xrdb -merge ~/.Xresources
```