Please enable JavaScript to view this site.

Navigation: TCC > Commands

TCNOTIFY

Scroll Prev Top Next More
Purpose:Send a terminal notification from TCC or a batch file.

 

Format:TCNOTIFY "message"

TCNOTIFY "title" "message"

 

Usage:

 

The message-only form emits an OSC 9 notification; the title-and-message form emits OSC 777. Both are written 

to standard output. A compatible terminal must interpret the sequence; redirected output receives the escape 

sequence as UTF-8 bytes rather than displaying a notification.

 
In a Take Command ConPTY tab, enable SINotifications=Yes in the Take Command configuration. Take 

Command suppresses these notifications for the active tab; Windows notification settings can also prevent a 

toast from appearing. Clicking a displayed toast returns to the sending tab.

 
The message-only form requires a nonempty message. The titled form requires a nonempty title and message. A 

message may contain semicolons; a title may not. Control characters are not allowed. The title is limited to 

256 UTF-8 bytes and the message to 4096 UTF-8 bytes.

 
In Take Command, a message-only notification whose initial integer is 4, 9, or 12 can be interpreted as a 

different OSC 9 command. Use the title-and-message form for such messages.

 

Examples:

 

TCNOTIFY "Backup finished"

 
TCNOTIFY "Build" "All tests passed"