1
0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-12-27 12:13:37 +08:00
ohmyzsh/plugins/iterm2/README.md
2024-03-26 09:55:16 +01:00

1.3 KiB

iTerm2 plugin

This plugin adds a few functions that are useful when using iTerm2.

To use it, add iterm2 to the plugins array of your zshrc file:

plugins=(... iterm2)

Optionally, the plugin also applies the Shell Integration Script for iTerm2.
You can enable the integration with zstyle. It's important to add this line
before the line sourcing oh-my-zsh:

zstyle :omz:plugins:iterm2 shell-integration yes

Plugin commands

  • _iterm2_command <iterm2-command>
    executes an arbitrary iTerm2 command via an escape code sequence.
    See https://iterm2.com/documentation-escape-codes.html for all supported commands.

  • iterm2_profile <profile-name>
    changes the current terminal window's profile (colors, fonts, settings, etc).
    profile-name is the name of another iTerm2 profile. The profile name can contain spaces.

  • iterm2_tab_color <red> <green> <blue>
    changes the color of iTerm2's currently active tab.
    red/green/blue are on the range 0-255.

  • iterm2_tab_color_reset
    resets the color of iTerm2's current tab back to default.

For shell integration features see the official documentation.

Contributors