Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/matiasOliva64/dotfiles-Hyprland-fedora/llms.txt

Use this file to discover all available pages before exploring further.

Dunst is a lightweight, highly configurable notification daemon that receives desktop notifications from applications and renders them as pop-up banners. In this setup it is launched automatically by Hyprland at session start and styled with the Catppuccin Mocha color palette — a dark navy background with soft blue borders and light text. Notifications appear in the top-right corner of the screen. Hyprland keybindings let you dismiss individual notifications or clear them all without touching the mouse.

​
Global settings

[global]
font = JetBrainsMono 10
frame_width = 2
corner_radius = 10
width = 320
height = 100
offset = 10x50
origin = top-right
background = "#1e1e2e"
foreground = "#cdd6f4"
frame_color = "#89b4fa"
separator_height = 2
padding = 10
horizontal_padding = 10
Notifications appear at top-right with an offset of 10x50 — 10 pixels from the right edge and 50 pixels from the top. This places them just below the Waybar status bar without overlapping it. Each popup is a maximum of 320 pixels wide and 100 pixels tall.
JetBrainsMono at 10 pt matches the monospace aesthetic of the rest of the desktop. There is no Nerd Font variant specified here because notification body text rarely needs icon glyphs.
The background (#1e1e2e) and foreground (#cdd6f4) are Catppuccin Mocha’s base and text colors. The frame uses Catppuccin’s blue (#89b4fa) for a subtle colored border. Rounded corners at 10 px match the rounding = 10 set in Hyprland’s decoration block. A 2-pixel separator is drawn between stacked notifications.

​
Urgency levels

Dunst sorts incoming notifications into three urgency tiers — low, normal, and critical — and applies separate color rules to each. 
[urgency_low]
    background = "#1E1E2E"
    foreground = "#CDD6F4"
    frame_color = "#89B4FA"

[urgency_normal]
    background = "#1E1E2E"
    foreground = "#CDD6F4"
    frame_color = "#89B4FA"

[urgency_critical]
    background = "#1E1E2E"
    foreground = "#CDD6F4"
    frame_color = "#F38BA8"
low and normal notifications share the same appearance: the Catppuccin Mocha base background, standard text color, and a blue frame. critical notifications keep the same background and text but switch the frame to Catppuccin’s red (#F38BA8), making urgent alerts immediately distinguishable at a glance.
No explicit timeout is set in this configuration, so Dunst uses its compiled-in defaults: 10 seconds for low urgency, 10 seconds for normal, and 0 (no auto-dismiss) for critical notifications.

​
Controlling notifications from the keyboard

Hyprland binds three Dunst control commands so you can manage notifications without leaving the keyboard:
KeybindCommandEffect
Super + Ndunstctl closeDismiss the most recent notification
Super + Hdunstctl history-popBring back the last dismissed notification
Super + Shift + Ndunstctl close-allDismiss all pending notifications at once
dunstctl history-pop is useful when a notification disappears before you had time to read it. It re-displays the most recently closed popup so you can act on it.

Build docs developers (and LLMs) love

Get started for freeTalk to us