List Keybindings

Termy provides commands to inspect keyboard shortcuts, available actions, and theme colors.

List Keybindings

The -list-keybinds command displays all active keyboard shortcuts in your configuration.

Usage

termy-cli -list-keybinds

What It Does

This command:

Loads your configuration file
Parses keybind directives
Resolves keybindings (including defaults)
Displays each binding with metadata

Example Output

secondary-t = new_tab	available=true	tmux_required=false	restart_required=false
secondary-w = close_tab	available=true	tmux_required=false	restart_required=false
secondary-n = new_window	available=true	tmux_required=false	restart_required=false
secondary-p = toggle_command_palette	available=true	tmux_required=false	restart_required=false
secondary-, = open_settings	available=true	tmux_required=false	restart_required=false
control-shift-c = copy	available=true	tmux_required=false	restart_required=false
control-shift-v = paste	available=true	tmux_required=false	restart_required=false
secondary-= = zoom_in	available=true	tmux_required=false	restart_required=false
secondary-- = zoom_out	available=true	tmux_required=false	restart_required=false
secondary-0 = zoom_reset	available=true	tmux_required=false	restart_required=false
secondary-alt-shift-left = resize_pane_left	available=false	tmux_required=true	restart_required=true
secondary-alt-shift-right = resize_pane_right	available=false	tmux_required=true	restart_required=true

Output Format

Each line contains:

Trigger: Key combination (e.g., secondary-t, control-shift-c)
Action: Command to execute (e.g., new_tab, copy)
Metadata (tab-separated):
- available: Whether action is currently enabled
- tmux_required: Whether action requires tmux mode
- restart_required: Whether enabling requires restart

secondary is a platform-aware modifier:

macOS: Cmd (⌘)
Linux/Windows: Ctrl

Use Cases

Finding a Specific Keybinding

termy-cli -list-keybinds | grep "copy"

Identifying Tmux-Only Keybinds

termy-cli -list-keybinds | grep "tmux_required=true"

These keybindings only work when tmux_enabled = true in your config.

Exporting Keybindings

termy-cli -list-keybinds > my-keybinds.txt

List Actions

The -list-actions command shows all available actions you can bind to keyboard shortcuts.

Usage

termy-cli -list-actions

What It Does

This command lists every action available in Termy, with metadata indicating:

Whether it’s currently available
Whether it requires tmux mode
Whether enabling it requires a restart

Example Output

new_tab	available=true	tmux_required=false	restart_required=false
close_tab	available=true	tmux_required=false	restart_required=false
new_window	available=true	tmux_required=false	restart_required=false
toggle_command_palette	available=true	tmux_required=false	restart_required=false
copy	available=true	tmux_required=false	restart_required=false
paste	available=true	tmux_required=false	restart_required=false
zoom_in	available=true	tmux_required=false	restart_required=false
zoom_out	available=true	tmux_required=false	restart_required=false
resize_pane_left	available=false	tmux_required=true	restart_required=true
resize_pane_right	available=false	tmux_required=true	restart_required=true
install_cli	available=true	tmux_required=false	restart_required=false

Action Categories

Window & Tab Management

new_tab: Create a new tab
close_tab: Close current tab
new_window: Open a new window
select_next_tab: Switch to next tab
select_previous_tab: Switch to previous tab

Text Operations

copy: Copy selected text
paste: Paste from clipboard
select_all: Select all text

View & Display

zoom_in: Increase font size
zoom_out: Decrease font size
zoom_reset: Reset to default font size
toggle_fullscreen: Enter/exit fullscreen

Pane Management (Tmux)

split_horizontal: Split pane horizontally
split_vertical: Split pane vertically
resize_pane_left: Resize pane left
resize_pane_right: Resize pane right
resize_pane_up: Resize pane up
resize_pane_down: Resize pane down

These actions require tmux_enabled = true in your configuration.

Settings & Navigation

Use Cases

Finding Available Actions

termy-cli -list-actions | grep "pane"

Listing Non-Tmux Actions

termy-cli -list-actions | grep "tmux_required=false"

Creating Custom Keybindings

Use -list-actions to discover action names for your custom bindings:

Find action name

termy-cli -list-actions | grep "zoom"

Add to configuration

termy-cli -edit-config

# Custom zoom keybindings
keybind = control-plus=zoom_in
keybind = control-minus=zoom_out

Validate

termy-cli -validate-config

List Colors

The -list-colors command displays the color palette for your currently active theme.

Usage

termy-cli -list-colors

What It Does

This command:

Loads your configuration
Reads the active theme
Resolves theme colors
Displays the complete color palette

Example Output

Theme: nord

foreground = #d8dee9
background = #2e3440
cursor = #d8dee9
black = #3b4252
red = #bf616a
green = #a3be8c
yellow = #ebcb8b
blue = #81a1c1
magenta = #b48ead
cyan = #88c0d0
white = #e5e9f0
bright_black = #4c566a
bright_red = #bf616a
bright_green = #a3be8c
bright_yellow = #ebcb8b
bright_blue = #81a1c1
bright_magenta = #b48ead
bright_cyan = #8fbcbb
bright_white = #eceff4

Color Properties

Property	Description
`foreground`	Default text color
`background`	Terminal background color
`cursor`	Cursor color
`black` – `white`	Standard ANSI colors (0-7)
`bright_black` – `bright_white`	Bright ANSI colors (8-15)

Use Cases

Inspecting Theme Colors

View colors before committing to a theme:

termy-cli -list-colors

Extracting Specific Colors

termy-cli -list-colors | grep "^background"

Creating Custom Theme

Use an existing theme as a starting point:

# Export nord colors
termy-cli -list-colors > nord-base.txt

# Edit to create your custom theme
termy-cli -edit-config

theme = "my-custom-theme"

[colors]
# Modified nord colors
foreground = "#d8dee9"
background = "#1a1f2e"  # Darker background
cursor = "#88c0d0"      # Cyan cursor
# ... rest of colors

Keybinding Configuration

See the Keybindings Configuration guide for detailed information on:

Custom keybinding syntax
Modifier keys
Unbinding defaults
Platform-specific bindings

Edit Config

Create custom keybindings

Validate Config

Check keybinding syntax

List Themes

Browse available themes

Interactive TUI

Visual keybinding browser

Commands

List Keybindings