Skip to main content
Version: 0.0.8

histui replay

Replay historical notifications through the active notification daemon.

Synopsis

histui replay [index|id] [flags]

Description

The replay command sends a notification from history back through D-Bus to the currently active notification daemon (histuid, dunst, mako, etc.).

When replaying to histuid:

  • The original notification is marked as replayed (shows R indicator in TUI)
  • No duplicate history entry is created
  • Original images and metadata are preserved

When replaying to other daemons:

  • The notification appears as a new notification
  • Custom hints (x-histui-replay, x-histui-original-id) identify it as a replay

Pipe Support

When stdin is a pipe and no arguments are provided, the command automatically reads a notification selection from stdin. This enables clean pipe workflows without xargs:

histui get | fuzzel -d | histui replay

Options

FlagTypeDefaultDescription
--indexintLookup notification by 1-based index
--idstringLookup notification by histui ID
--stdinboolfalseForce reading from stdin (auto-detected when piped)
--timeoutint-1Custom timeout in milliseconds (-1 = server default)
--sincedurationFilter: replay notifications from the last duration
--appstringFilter: only replay notifications from this app
--urgencystringFilter: only replay notifications with this urgency
--limitint10Maximum notifications to replay in batch mode
--allboolfalseRequired for batch replay with filters

Examples

Replay the most recent notification

histui replay 1

Replay by notification ID

histui replay 01HXYZ123ABC456DEF789GHI

Replay with custom timeout (10 seconds)

histui replay 1 --timeout 10000
# Interactive selection with fuzzel
histui get | fuzzel -d | histui replay

# Interactive selection with rofi
histui get | rofi -dmenu | histui replay

# Interactive selection with walker
histui get | walker -d | histui replay

# Interactive selection with fzf
histui get | fzf | histui replay

Batch replay with filters

# Replay all critical notifications from the last hour
histui replay --since 1h --urgency critical --all

# Replay last 5 notifications from Discord
histui replay --app discord --limit 5 --all

Pipeline Workflows

Copy and replay workflow

# Select a notification, copy its body, then replay it
histui get | fuzzel -d | tee >(histui replay) | cut -d'|' -f1 | xargs histui get --field body | wl-copy

Replay missed notifications

# Replay all unseen notifications from the last 2 hours (with delay between each)
histui get --filter "seen=false" --since 2h --format ids | while read id; do
histui replay "$id"
sleep 1
done

TUI Replay

You can also replay notifications from the TUI:

  1. Open the TUI: histui
  2. Navigate to a notification
  3. Press R to replay

Replayed notifications show an R indicator in the left margin.

See Also