Please enable JavaScript to view this site.

Navigation: Take Command

Multi-Chord Hotkeys

Scroll Prev Top Next More



Take Command lets you assign an existing command to a one-key shortcut or a two-key sequence, also called a multi-chord hotkey. For example:

 

Ctrl+K, Ctrl+C

 

After you press Ctrl+K, press Ctrl+C to run the assigned Take Command command. Multi-chord hotkeys work throughout Take Command, including focused Local, SSH, Serial, and torn-off terminal tabs.

 

Create or change a hotkey

 

1.Open Take Command existing Customize dialog and select the Keyboard page.

2.Select the command you want to assign. A multi-chord hotkey can invoke only an existing Take Command command; it cannot send arbitrary terminal text, scripts, or macros.

3.In the shortcut entry field, press the first chord, then press the second chord.

4.Confirm the assignment. The Keyboard page displays conflicts and lets you replace or remove an existing assignment.

5.Apply or close the dialog. Assignments are saved with the normal command-bar customizations in TCMD.INI.

 

Use the format Ctrl+K, Ctrl+C when describing or recording an assignment: the comma separates the first and second chords.

 

Using a multi-chord hotkey

 

When you press a configured first chord, Take Command displays a status-bar prompt showing the prefix and that it is waiting for the second key. Press the matching second chord within 1.5 seconds to execute the command.

 

While a sequence is pending:

 

•Esc cancels it.

•Moving focus to another control, tab, or window cancels it.

•Closing or deactivating the owning window cancels it.

•An invalid second key or the 1.5-second timeout cancels it.

 

Cancellation runs no command. More importantly, Take Command  consumes both the prefix and invalid/expired suffix instead of sending them into the focused terminal. This prevents an abandoned shortcut from Take Command an accidental shell command or control character.

 

Rules and conflicts

 

•Take Command supports a maximum of two chords per shortcut.

•A first chord cannot be both a complete one-key shortcut and the prefix of a two-key shortcut. The Customize page rejects this ambiguous assignment.

•Exact duplicate assignments are rejected.

•Existing one-key shortcuts keep their normal behavior.

•The Command Palette shows the current assigned shortcut, including a customized two-chord sequence.

•Shortcut customization mode does not execute normal commands while you are recording or editing an assignment.

 

Terminal and editor behavior

 

Take Command checks configured multi-chord prefixes before eligible terminal key-down messages are converted to terminal input. This provides consistent behavior in Local, SSH, Serial, and replay tabs, while preserving normal unassigned terminal input.

 

IME composition and packet input retain their normal precedence and are not treated as shortcut chords. Native editing controls, such as the command-input editor, retain their editing behavior unless the established shortcut manager processes an explicitly configured command shortcut.

 

Troubleshooting

 

Symptom

What to check

The command runs after the first key.

Check that the first chord is not also assigned as a one-key shortcut.

Nothing happens after entering a sequence.

Enter the second chord within 1.5 seconds and verify the command is still assigned in Customize > Keyboard.

The sequence is canceled.

Check whether focus moved, Esc was pressed, or the second chord does not exactly match the assignment.

Keys are not reaching the terminal.

A configured prefix was recognized. Complete the second chord or wait for/cancel the sequence; assign a different prefix if the keys are needed by the terminal.

A shortcut does not persist after restart.

Apply the customization normally and verify that Take Command can write its TCMD.INI CommandBars settings.

 

Use a one-key shortcut for a frequent action that does not conflict with terminal input. Use a two-chord shortcut when you need an expressive command binding while keeping the first chord unavailable to accidental terminal input.