Skip to main content
Version: 0.0.5

histui

histui (pronounced his-too-ee) is a notification system for Linux Wayland desktops. It captures, displays, and lets you browse your notification history.

How to pronounce it

The name is a play on "history" + "TUI":

  • histuihis-too-ee
  • histuid (the daemon) → his-too-ee-dee

What You Can Do

Display Notifications

histuid is a GTK4-based notification daemon for Wayland compositors. It:

  • CSS theming with hot reload - edit themes live without restarting
  • Clickable URLs and deep links - jump straight to the source app
  • Image previews and progress bars with Pango markup support
  • Smart icon resolution - app aliases with Nerd Font fallbacks for 350+ apps
  • Audio alerts by urgency with repeat options
  • Notification stacking with smooth animations
  • Supports Hyprland, Sway, river, and other layer-shell compositors

Browse Your History

histui is a CLI and TUI for querying notification history. You can:

  • View what you missed while away
  • Filter by app, urgency, or time range
  • Output in JSON for scripts or dmenu for launchers
  • Show notification counts in Waybar or Polybar

Run Alongside Other Daemons

Want to keep dunst or mako for display but use histui for history? Monitor mode listens to an existing notification daemon and records all notifications to history - without displaying popups or taking over the D-Bus name.

Quick Start

# Install (Arch Linux)
yay -S histui-bin

# Start the daemon
histuid

# Query your history
histui get --app discord --since 1h
Wayland Required

histuid requires a Wayland compositor with layer-shell support. The histui CLI works on both X11 and Wayland.

Next Steps

🚀 Get Started

Install and run histuid in 5 minutes

→ Quickstart Guide

🎨 Customize

Match notifications to your theme

→ Theming Guide

🔍 Browse History

Find and filter past notifications

→ CLI Commands