Notifications
Open Settings → Notifications to choose alerts for unseen output in background tabs. All three options start off.
Notification Options
| Setting | What It Does |
|---|---|
| Play a sound | Plays a short chime when a background tab gets an unseen-output bell. |
| Show an in-app notification | Shows a toast naming the tab, such as New activity in "build". It stays until you dismiss it or open that tab. |
| Show OS notifications when TermFlow isn't focused | Sends a native notification when none of TermFlow's windows is focused. Click the notification to bring TermFlow forward and open its tab. |
What Triggers an Alert
Alerts follow the unseen-output bell, rather than every line printed by a terminal. A background tab must produce output and then settle idle for two seconds. Its bell has the tooltip New output you haven't seen yet. Looking at the tab clears the bell; more output while it already has a bell does not produce another alert.
TermFlow suppresses alerts while startup settles and briefly during terminal reconnection. The tab you're viewing does not generate these alerts.
Sound and in-app toasts can alert you while you're working in another TermFlow tab. OS notifications require every TermFlow window to be unfocused.
Mute a Tab or Pane
Right-click a tab and choose Mute Notifications to mute all its panes. Unmute Notifications restores alerts. Muting a tab clears its pending bell, and the tab's mute setting survives a restart.
For one pane, right-click its header and choose Mute Pane Notifications. Use Unmute Pane Notifications to turn them back on. A muted tab takes precedence over an individual pane's setting. Muting suppresses the unseen-output bell as well as its alerts.
See Tabs and Split panes for the other menu actions.
Clicking Notifications
A native notification click selects its tab in the window that owns it, even if you moved the tab to another window. If the tab has closed, TermFlow brings the originating window forward. Ordinary window focus, such as switching back with Alt+Tab, leaves your current tab selected.
Clicking an in-app toast dismisses it. Opening the tab also removes its toast.
An honest note: On Linux under Wayland, selecting the notified tab works, but bringing its window to the foreground depends on the desktop environment.