Rules

Rules

Rules apply per-notification overrides based on app metadata and notification fields. All matches are case-insensitive substring matches.

Fields

• name: optional rule label for logging.
• app: app name match.
• summary: summary match.
• body: body match.
• category: category hint match.
• urgency: low, normal, critical (or 0, 1, 2).
• no_popup: suppress popups.
• silent: suppress sound.
• force_urgency: override urgency (low, normal, critical).
• expire_timeout_ms: override timeout (-1 default, 0 never expire).
• resident: force resident flag.
• transient: force transient flag.

Order

Rules are evaluated in order. Later rules can override earlier ones.

Examples

[[rules]]
name = "quiet-slack"
app = "slack"
no_popup = true
silent = true

[[rules]]
name = "critical-alerts"
summary = "alert"
force_urgency = "critical"
expire_timeout_ms = 10000