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" = cygwin ]] && return 0
50 [[ "$TERM" = putty* ]] && return 0
51 [[ "$TERM" = screen* ]] && return 0
52 [[ "$TERM" = tmux* ]] && return 0
53 [[ "$TERM" = xterm* ]] && return 0
57 # Test for "dumb" terminal
58 function axzsh_is_dumb_terminal {
59 axzsh_is_modern_terminal && return 1
60 [[ "$TERM" = dumb* ]] && return 0
61 [[ "$TERM" = "vt52" ]] && return 0
65 # Resize terminal window (when possible)
66 function axzsh_resize_terminal {
67 printf '\e[8;%d;%dt' "$2" "$1"
72 # Set terminal "hardstatus" and "icon title"
73 function axzsh_terminal_set_icon_title {
74 [[ "$TERM" == "screen"* ]] && printf '\ek%s\e\\' "$1"
75 printf '\e]1;%s\a' "$1"
78 # Set terminal window title
79 function axzsh_terminal_set_window_title {
80 printf '\e]2;%s\a' "$1"
83 # Update terminal titles befor echoing the shell prompt
84 function axzsh_terminal_title_precmd {
85 axzsh_is_modern_terminal || return
86 axzsh_terminal_set_window_title ''
87 if [[ "$TERM_PROGRAM" == "Apple_Terminal" && "$TERM" != "screen"* ]]; then
88 axzsh_terminal_set_icon_title "$LOGNAME@$SHORT_HOST"
89 # Update CWD in Terminal.app
90 local url=$(echo "file://$HOSTNAME$PWD" | sed -e 's| |%20|g')
91 printf '\e]7;%s\a' "$url"
93 axzsh_terminal_set_icon_title "$LOGNAME@$SHORT_HOST:$PWD"
97 precmd_functions+=(axzsh_terminal_title_precmd)
99 # Update terminal titles befor executing a command
100 function axzsh_terminal_title_preexec {
101 axzsh_is_modern_terminal || return
103 local cmd="${1[(w)1]}"
107 "mosh"*|"root"*|"ssh"*|"telnet"*)
111 if [[ "$TERM_PROGRAM" == "Apple_Terminal" ]]; then
112 # Apple Terminal.app ...
113 if [[ -n "$remote" ]]; then
114 # Reset CWD for remote commands
115 printf '\e]7;%s\a' ''
119 if [[ -n "$cmd" ]]; then
120 # Add the command to the title
124 if [[ -z "$remote" ]]; then
125 axzsh_terminal_set_icon_title "$LOGNAME@$SHORT_HOST$TITLE_ADD"
127 axzsh_terminal_set_icon_title "$1"
131 preexec_functions+=(axzsh_terminal_title_preexec)
133 alias axttyinfo="zsh \"\$AXZSH/bin/axttyinfo\""
135 axzsh_is_dumb_terminal && return 0
138 # See <https://en.wikipedia.org/wiki/ANSI_escape_code#Colors>, for exmaple.
143 if axzsh_is_modern_terminal; then
151 # Foreground (FG) and background (BG) colors.
156 for color in {000..$TERM_COLORS}; do
157 FG[$color]="%{\e[38;5;${color}m%}"
158 BG[$color]="%{\e[48;5;${color}m%}"
164 for color in {000..$TERM_COLORS}; do
166 if [[ $c -ge 8 ]]; then
170 FG[$color]="%{\e[${p}3${c}m%}"
171 BG[$color]="%{\e[${p}4${c}m%}"
178 # See <https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters>, for example.
183 bold "%{\e[1m%}" no-bold "%{\e[22m%}"
184 italic "%{\e[3m%}" no-italic "%{\e[23m%}"
185 underline "%{\e[4m%}" no-underline "%{\e[24m%}"
186 blink "%{\e[5m%}" no-blink "%{\e[25m%}"
187 reverse "%{\e[7m%}" no-reverse "%{\e[27m%}"
190 ZSH_SPECTRUM_TEXT=${ZSH_SPECTRUM_TEXT:-The quick brown fox jumps over the lazy dog}
192 # Show all 256 foreground colors with color number
193 function spectrum_ls() {
194 for code in {000..$TERM_COLORS}; do
195 print -P -- "$code: $FG[$code]$ZSH_SPECTRUM_TEXT$FX[reset]"
199 # Show all 256 background colors with color number
200 function spectrum_bls() {
201 for code in {000..$TERM_COLORS}; do
202 print -P -- "$code: $BG[$code]$ZSH_SPECTRUM_TEXT$FX[reset]"
206 # NOTE for FG, BG and FX arrays, and spectrum_ls() and spectrum_bls() functions:
207 # Based on a script to make using 256 colors in zsh less painful, written by
208 # P.C. Shyamshankar <sykora@lucentbeing.com>.
209 # Copied from OhMyZsh https://github.com/robbyrussell/oh-my-zsh/blob/master/lib/spectrum.zsh
210 # which was copied from https://github.com/sykora/etc/blob/master/zsh/functions/spectrum/ :-)