1 # AX-ZSH: Alex' Modular ZSH Configuration
2 # 11_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 # Get the length of a string when shown on the terminal. The return code of the
25 # function is the length in "cells". Note: Echo'ing the length to the terminal,
26 # which looks cleaner at first, doesn't work: this command can't be called with
27 # its stdin and/or stdout redirected, as it it must be able to interact with the
28 # terminal (write to and read from it).
29 function axzsh_get_displayed_length {
34 return $((${pos#*;} - 1))
37 # Check if terminal correctly handles "wide" characters, which means, displays
38 # them with the correct width (>1).
39 # <https://unix.stackexchange.com/questions/184345/detect-how-much-of-unicode-my-terminal-supports-even-through-screen>
40 typeset -g _axzsh_is_widechar_terminal_cache
41 function axzsh_is_widechar_terminal {
42 if [[ -z "$_axzsh_is_widechar_terminal_cache" ]]; then
43 # No cached result, call test function ...
44 _axzsh_is_widechar_terminal
45 _axzsh_is_widechar_terminal_cache=$?
47 return $_axzsh_is_widechar_terminal_cache
49 function _axzsh_is_widechar_terminal {
50 [[ -t 1 ]] || return 1
51 [[ -z "$AXZSH_PLUGIN_CHECK" ]] || return 1
52 axzsh_is_utf_terminal || return 1
53 axzsh_get_displayed_length "🍀"
54 [[ $? -eq 2 ]] && return 0 || return 1
57 # Test for "modern" terminal
58 function axzsh_is_modern_terminal {
59 [[ "$TERM" = cygwin ]] && return 0
60 [[ "$TERM" = putty* ]] && return 0
61 [[ "$TERM" = screen* ]] && return 0
62 [[ "$TERM" = tmux* ]] && return 0
63 [[ "$TERM" = xterm* ]] && return 0
67 # Test for "dumb" terminal
68 function axzsh_is_dumb_terminal {
69 axzsh_is_modern_terminal && return 1
70 [[ "$TERM" = dumb* ]] && return 0
71 [[ "$TERM" = "vt52" ]] && return 0
75 # Resize terminal window (when possible)
76 function axzsh_resize_terminal {
77 printf '\e[8;%d;%dt' "$2" "$1"
82 # Set terminal "hardstatus" and "icon title"
83 function axzsh_terminal_set_icon_title {
84 [[ "$TERM" == "screen"* ]] && printf '\ek%s\e\\' "$1"
85 printf '\e]1;%s\a' "$1"
88 # Set terminal window title
89 function axzsh_terminal_set_window_title {
90 printf '\e]2;%s\a' "$1"
93 # Update terminal titles befor echoing the shell prompt
94 function axzsh_terminal_title_precmd {
95 axzsh_is_modern_terminal || return
96 axzsh_terminal_set_window_title ''
97 if [[ "$TERM_PROGRAM" == "Apple_Terminal" && "$TERM" != "screen"* ]]; then
98 axzsh_terminal_set_icon_title "$LOGNAME@$SHORT_HOST"
99 # Update CWD in Terminal.app
100 local url=$(echo "file://$HOST$PWD" | sed -e 's| |%20|g')
101 printf '\e]7;%s\a' "$url"
103 axzsh_terminal_set_icon_title "$LOGNAME@$SHORT_HOST:$PWD"
107 precmd_functions+=(axzsh_terminal_title_precmd)
109 # Update terminal titles befor executing a command
110 function axzsh_terminal_title_preexec {
111 axzsh_is_modern_terminal || return
113 local cmd="${1[(w)1]}"
117 "mosh"*|"root"*|"ssh"*|"telnet"*)
121 if [[ "$TERM_PROGRAM" == "Apple_Terminal" ]]; then
122 # Apple Terminal.app ...
123 if [[ -n "$remote" ]]; then
124 # Reset CWD for remote commands
125 printf '\e]7;%s\a' ''
129 if [[ -n "$cmd" ]]; then
130 # Add the command to the title
134 if [[ -z "$remote" ]]; then
135 axzsh_terminal_set_icon_title "$LOGNAME@$SHORT_HOST$TITLE_ADD"
137 axzsh_terminal_set_icon_title "$1"
141 preexec_functions+=(axzsh_terminal_title_preexec)
143 alias axttyinfo="zsh \"\$AXZSH/bin/axttyinfo\""
145 axzsh_is_dumb_terminal && return 0
148 # See <https://en.wikipedia.org/wiki/ANSI_escape_code#Colors>, for exmaple.
153 if axzsh_is_modern_terminal; then
161 # Foreground (FG) and background (BG) colors.
166 for color in {000..$TERM_COLORS}; do
167 FG[$color]="%{\e[38;5;${color}m%}"
168 BG[$color]="%{\e[48;5;${color}m%}"
174 for color in {000..$TERM_COLORS}; do
176 if [[ $c -ge 8 ]]; then
180 FG[$color]="%{\e[${p}3${c}m%}"
181 BG[$color]="%{\e[${p}4${c}m%}"
188 # See <https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters>, for example.
193 bold "%{\e[1m%}" no-bold "%{\e[22m%}"
194 italic "%{\e[3m%}" no-italic "%{\e[23m%}"
195 underline "%{\e[4m%}" no-underline "%{\e[24m%}"
196 blink "%{\e[5m%}" no-blink "%{\e[25m%}"
197 reverse "%{\e[7m%}" no-reverse "%{\e[27m%}"
200 ZSH_SPECTRUM_TEXT=${ZSH_SPECTRUM_TEXT:-The quick brown fox jumps over the lazy dog}
202 # Show all 256 foreground colors with color number
203 function spectrum_ls() {
204 for code in {000..$TERM_COLORS}; do
205 print -P -- "$code: $FG[$code]$ZSH_SPECTRUM_TEXT$FX[reset]"
209 # Show all 256 background colors with color number
210 function spectrum_bls() {
211 for code in {000..$TERM_COLORS}; do
212 print -P -- "$code: $BG[$code]$ZSH_SPECTRUM_TEXT$FX[reset]"
216 # NOTE for FG, BG and FX arrays, and spectrum_ls() and spectrum_bls() functions:
217 # Based on a script to make using 256 colors in zsh less painful, written by
218 # P.C. Shyamshankar <sykora@lucentbeing.com>.
219 # Copied from OhMyZsh https://github.com/robbyrussell/oh-my-zsh/blob/master/lib/spectrum.zsh
220 # which was copied from https://github.com/sykora/etc/blob/master/zsh/functions/spectrum/ :-)