Your Adaptable Widget Notification System

Table of contents

• Introduction
• Features
• Examples
• Installing

Introduction

Yawns is a notification manager (or daemon) written out of the necessity for highly customizable, adaptable notifications. Why would your notification for a brightness change look the same as your Spotify song change notification? Or even an email one? This is where Yawns introduces the concept of, uhm, well, yawns.

A yawn is a window displaying the contents of a notification. So far, the following yawns are available:

• Corner yawn: The most classic notification design. Shows up as a window anchored to one of the corners of your screen. Multiple notifications stack vertically. Ideal for things like e-mail notifications.
• Center yawn: Show a notification in the center of the screen. Multiple notifications stack vertically one behind the other. Meant mostly for displaying quick settings changes like volume, brightness or keyboard layout.
• Media yawn: Like a corner yawn, but this one shows the notification icon as a spinning vinyl disc and doesn't stack, each new yawn replaces the last one (if it's still open). Your Spotify notifications are gonna look amazing with this one.

When a notification is received, if the hint yawn_type is provided (like when running notify-send hello -h int:yawn_type:1), the manager will use the specified yawn type to display the notification, following the order from the above list starting from 1.

There are more yawn types to come but you're more than welcome to open an issue suggesting any cool ideas you might have :)

You can read more about how Yawns work in the wiki

Features

• Full markup on summary and body
• Full control of per-yawn QSS (kinda like CSS)
• Scripting via an external command set in configs
• Completely different yawns (notification windows) based on notification hints

Examples

These are some of the cool notifications I'm currently using yawns for :)

All the notifications below are either sent by applications or through the notify-send core util. No extra tool is needed

A center yawn with a workspace change notification

Featuring some markdown to change font size and color on certain characters, from this script

A center yawn with a brightness/volume change notification

With corresponding icon and bar percentage, from these brightness and volume scripts

A corner yawn with a text message with action buttons (Whatsapp)

A corner yawn with a battery warning notification

From this script

A media yawn with a Spotify notification

Installing

Either install from the official AUR package or run install.sh as root.