1 # AX-ZSH: Alex' Modular ZSH Configuration
2 # 10_terminal.zshrc: Initialize terminal settings
4 # Fix up TERM. Do this here (and not in zprofile), because terminal emulators
5 # often don't start a new login shell but "only" a new interactive shell.
7 # VTE based terminals (like GNOME Terminal) support 256 colors, but old(er)
8 # versions of GNOME Terminal (at least) set TERM=xterm ...
9 [[ "$TERM" = "xterm" && "$VTE_VERSION" != "" ]] && TERM="xterm-256color"
11 # Common helper functions
13 # Check if terminal supports Unicode.
14 # <https://wiki.grml.org/doku.php?id=utf8>
15 function axzsh_is_utf_terminal {
16 case "$LANG $CHARSET $LANGUAGE" in
22 alias isutfenv=axzsh_is_utf_terminal
24 # Check if terminal supports "wide" characters.
25 # <https://unix.stackexchange.com/questions/184345/detect-how-much-of-unicode-my-terminal-supports-even-through-screen>
26 typeset -g _axzsh_is_widechar_terminal_cache
27 function axzsh_is_widechar_terminal {
28 if [[ -z "$_axzsh_is_widechar_terminal_cache" ]]; then
29 # No cached result, call test function ...
30 _axzsh_is_widechar_terminal
31 _axzsh_is_widechar_terminal_cache=$?
33 return $_axzsh_is_widechar_terminal_cache
35 function _axzsh_is_widechar_terminal {
36 [[ -t 1 ]] || return 1
37 [[ -z "$AXZSH_PLUGIN_CHECK" ]] || return 1
38 axzsh_is_utf_terminal || return 1
43 [[ "${pos#*;}" -eq 2 ]] || return 1
47 # Test for "modern" terminal
48 function axzsh_is_modern_terminal {
49 [[ "$TERM" = screen* ]] && return 0
50 [[ "$TERM" = tmux* ]] && return 0
51 [[ "$TERM" = xterm* ]] && return 0
52 [[ "$TERM" = cygwin ]] && return 0
56 # Test for "dumb" terminal
57 function axzsh_is_dumb_terminal {
58 axzsh_is_modern_terminal && return 1
59 [[ "$TERM" = dumb* ]] && return 0
60 [[ "$TERM" = "vt52" ]] && return 0
64 # Resize terminal window (when possible)
65 function axzsh_resize_terminal {
66 printf '\e[8;%d;%dt' "$2" "$1"
71 # Set terminal "hardstatus" and "icon title"
72 function axzsh_terminal_set_icon_title {
73 [[ "$TERM" == "screen"* ]] && printf '\ek%s\e\\' "$1"
74 printf '\e]1;%s\a' "$1"
77 # Set terminal window title
78 function axzsh_terminal_set_window_title {
79 printf '\e]2;%s\a' "$1"
82 # Update terminal titles befor echoing the shell prompt
83 function axzsh_terminal_title_precmd {
84 axzsh_is_modern_terminal || return
85 axzsh_terminal_set_icon_title 'zsh'
86 if [[ "$TERM_PROGRAM" == "Apple_Terminal" && "$TERM" != "screen"* ]]; then
87 axzsh_terminal_set_window_title "$LOGNAME@$SHORT_HOST"
88 # Update CWD in Terminal.app
89 local url=$(echo "file://$HOSTNAME$PWD" | sed -e 's| |%20|g')
90 printf '\e]7;%s\a' "$url"
92 axzsh_terminal_set_window_title "$LOGNAME@$SHORT_HOST:$PWD"
96 precmd_functions+=(axzsh_terminal_title_precmd)
98 # Update terminal titles befor executing a command
99 function axzsh_terminal_title_preexec {
100 axzsh_is_modern_terminal || return
102 local cmd="${1[(w)1]}"
106 "mosh"*|"root"*|"ssh"*|"telnet"*)
110 if [[ "$TERM_PROGRAM" == "Apple_Terminal" ]]; then
111 # Apple Terminal.app ...
112 if [[ -n "$remote" ]]; then
113 # Reset CWD for remote commands
114 printf '\e]7;%s\a' ''
117 if [[ "$TERM_PROGRAM" == "iTerm.app" ]]; then
119 [[ -n "$cmd" ]] && TITLE_ADD=" – $cmd"
122 axzsh_terminal_set_icon_title "$cmd"
124 if [[ -z "$remote" ]]; then
125 axzsh_terminal_set_window_title "$LOGNAME@$SHORT_HOST$TITLE_ADD"
127 axzsh_terminal_set_window_title "$1"
131 preexec_functions+=(axzsh_terminal_title_preexec)
133 alias axttyinfo="nocorrect zsh $AXZSH/bin/axttyinfo"
135 axzsh_is_dumb_terminal && return 0
142 if axzsh_is_modern_terminal; then
150 # Foreground (FG) and background (BG) colors.
152 for color in {000..255}; do
153 FG[$color]="%{
\e[38;5;${color}m%}"
154 BG[$color]="%{
\e[48;5;${color}m%}"
162 bold "%{
\e[01m%}" no-bold "%{
\e[22m%}"
163 italic "%{
\e[03m%}" no-italic "%{
\e[23m%}"
164 underline "%{
\e[04m%}" no-underline "%{
\e[24m%}"
165 blink "%{
\e[05m%}" no-blink "%{
\e[25m%}"
166 reverse "%{
\e[07m%}" no-reverse "%{
\e[27m%}"
169 ZSH_SPECTRUM_TEXT=${ZSH_SPECTRUM_TEXT:-The quick brown fox jumps over the lazy dog}
171 # Show all 256 foreground colors with color number
172 function spectrum_ls() {
173 for code in {000..255}; do
174 print -P -- "$code: %{$FG[$code]%}$ZSH_SPECTRUM_TEXT%{$reset_color%}"
178 # Show all 256 background colors with color number
179 function spectrum_bls() {
180 for code in {000..255}; do
181 print -P -- "$code: %{$BG[$code]%}$ZSH_SPECTRUM_TEXT%{$reset_color%}"
185 # NOTE for FG, BG and FX arrays, and spectrum_ls() and spectrum_bls() functions:
186 # Based on a script to make using 256 colors in zsh less painful, written by
187 # P.C. Shyamshankar <sykora@lucentbeing.com>.
188 # Copied from OhMyZsh https://github.com/robbyrussell/oh-my-zsh/blob/master/lib/spectrum.zsh
189 # which was copied from https://github.com/sykora/etc/blob/master/zsh/functions/spectrum/ :-)