Please enable JavaScript to view this site.

Navigation: Take Command

Desktop Notifications

Scroll Prev Top Next More

Take Command can display a Windows desktop toast notification when a shell command sends an OSC 9 or OSC 777 notification escape sequence to a tab or pane window. This lets long-running commands (builds, downloads, backups, and similar tasks) alert you when they finish, even if the tab isn't currently in the foreground.
 

Enabling Notifications

 

Enable Desktop Notifications in the **Shell Integration** group on the Advanced options
page of the Configure dialog.

 
The option is disabled (`No`) by default.

 

Behavior
 

•Notifications only fire for a tab that is **not** the currently active tab. If the tab sending   the OSC sequence is active and focused, no toast is shown, since you're already looking at it.

•Clicking a toast restores the Take Command window (if minimized) and activates and focuses the tab that sent the notification.

•Notifications use the standard Windows toast/Action Center notification system, so they follow your Windows notification settings (Focus Assist, per-app notification preferences, etc.).

 

Supported Escape Sequences

 
The simple, widely supported form used by rxvt/urxvt/iTerm2 and others:
 
ESC ] 9 ; <message> BEL
 
The toast title is "Take Command" and the body is <message>.

 
Example (from TCC):

 
printf \033]9;Build finished\007
 
The form used by some terminal emulators such as Konsole and Foot, allowing a distinct title:
 
ESC ] 777 ; notify ; <title> ; <body> BEL
 
The toast title is <title> and the body is <body>. Any semicolons inside <body> are preserved (they aren't treated as additional field separators).

 
Example (from TCC):
 
printf \033]777;notify;Backup;Backup completed successfully\007
 
The OSC 9;N subcommands are unaffected by this feature and do not produce a toast:

 

•OSC 9;4;<state>;<progress> — taskbar/tab progress indicator.

•OSC 9;9;<path> — working-directory sync.

•OSC 9;12 — ConEmu-style prompt-start shell-integration mark.

 
Only a bare OSC 9;<message> (no numeric subcommand recognized as one of the above) is treated as a notification.

 

Troubleshooting

 

•No toast appears: confirm "Desktop Notifications" is set in the Take Command options, and that the sending tab was not the active tab when the sequence was sent.

•No toast appears even on a background tab: check Windows notification settings for Take Command   (Settings > System > Notifications) and confirm Focus Assist isn't suppressing notifications.

•Clicking the toast does nothing: the originating tab may have been closed before the toast was clicked; the notification is dropped in that case.