|
|
|
|
# Terminal
|
|
|
|
|
|
|
|
|
|
Sets terminal window and tab titles.
|
|
|
|
|
|
|
|
|
|
## Settings
|
|
|
|
|
|
|
|
|
|
### Auto-Title
|
|
|
|
|
|
|
|
|
|
To auto set the terminal window and tab titles with the current command or
|
|
|
|
|
directory, add the following to _`${ZDOTDIR:-$HOME}/.zpreztorc`_:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
zstyle ':prezto:module:terminal' auto-title 'yes'
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Auto titling is disabled inside terminal multiplexers (except inside dvtm) since
|
|
|
|
|
it interferes with window names defined in configuration files and profile
|
|
|
|
|
managers. This can be overridden by setting it to `always`.
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
zstyle ':prezto:module:terminal' auto-title 'always'
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Title formats
|
|
|
|
|
|
|
|
|
|
To format terminal window and tab titles, add the following to
|
|
|
|
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
zstyle ':prezto:module:terminal:window-title' format '%n@%m: %s'
|
|
|
|
|
zstyle ':prezto:module:terminal:tab-title' format '%m: %s'
|
|
|
|
|
zstyle ':prezto:module:terminal:multiplexer-title' format '%s'
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
`%s` will be replaced with the current working directory path or the currently
|
|
|
|
|
executing program name.
|
|
|
|
|
|
|
|
|
|
For a list of sequences, see [Expansion of Prompt Sequences][1].
|
|
|
|
|
|
|
|
|
|
## Functions
|
|
|
|
|
|
|
|
|
|
- `set-tab-title` sets the terminal tab title.
|
|
|
|
|
- `set-window-title` sets the terminal window title.
|
|
|
|
|
- `set-multiplexer-title` sets the terminal multiplexer title.
|
|
|
|
|
|
|
|
|
|
## Authors
|
|
|
|
|
|
|
|
|
|
_The authors of this module should be contacted via the [issue tracker][2]._
|
|
|
|
|
|
|
|
|
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
|
|
|
- [Olaf Conradi](https://github.com/oohlaf)
|
|
|
|
|
|
|
|
|
|
[1]: https://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
|
|
|
|
|
[2]: https://github.com/sorin-ionescu/prezto/issues
|
