2018-10-05 07:29:43 +00:00
|
|
|
# iTerm2 plugin
|
|
|
|
|
|
|
|
|
|
This plugin adds a few functions that are useful when using [iTerm2](https://www.iterm2.com/).
|
|
|
|
|
|
2023-02-24 16:27:15 +00:00
|
|
|
|
2018-10-05 07:29:43 +00:00
|
|
|
To use it, add _iterm2_ to the plugins array of your zshrc file:
|
|
|
|
|
```
|
|
|
|
|
plugins=(... iterm2)
|
|
|
|
|
```
|
|
|
|
|
|
2023-02-24 16:27:15 +00:00
|
|
|
Optionally, the plugin also applies the [Shell Integration Script for iTerm2](https://iterm2.com/documentation-shell-integration.html).
|
2024-03-26 08:55:16 +00:00
|
|
|
You can enable the integration with zstyle. It's important to add this line
|
2023-02-24 16:27:15 +00:00
|
|
|
before the line sourcing oh-my-zsh:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
zstyle :omz:plugins:iterm2 shell-integration yes
|
|
|
|
|
```
|
|
|
|
|
|
2018-10-05 07:29:43 +00:00
|
|
|
## 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.
|
|
|
|
|
|
2023-02-24 16:27:15 +00:00
|
|
|
|
|
|
|
|
For shell integration features see the [official documentation](https://iterm2.com/documentation-shell-integration.html).
|
|
|
|
|
|
2018-10-05 07:29:43 +00:00
|
|
|
## Contributors
|
|
|
|
|
|
|
|
|
|
- [Aviv Rosenberg](https://github.com/avivrosenberg)
|
