1 # Zsh configuration file.
4 source_debug "sourcing ~/.zsh/rc"
6 # MISCELLANEOUS SETTINGS
8 # Use Vi(m) style key bindings.
11 # Be paranoid, new files are readable/writable by me only.
17 # Prevent overwriting existing files with '> filename', use '>| filename'
21 # Entering the name of a directory (if it's not a command) will automatically
22 # cd to that directory.
25 # When entering a nonexistent command name automatically try to find a similar
29 # Enable zsh's extended glob abilities.
32 # Don't exit if <C-d> is pressed.
38 # Make sure every entry in $fpath is unique.
40 # ~/.zsh/functions/completion is a symbolic link to the Completion directory
41 # of a Zsh CVS checkout. Use it to get the newest completions if available.
42 if [[ -d ~/.zsh/functions/completion ]]; then
43 fpath=(~/.zsh/functions/completion/*/*(/) $fpath)
45 # Set correct fpath to allow loading my functions (including completion
47 fpath=(~/.zsh/functions $fpath)
48 # Autoload my functions (except completion functions and hidden files). Thanks
49 # to caphuso from the Zsh example files for this idea.
50 if [[ -d ~/.zsh/functions ]]; then
51 autoload ${fpath[1]}/^_*(^/:t)
54 # Simulate hooks using _functions arrays for Zsh versions older than 4.3.4. At
55 # the moment only precmd(), preexec() and chpwd() are simulated.
57 # At least 4.3.4 (not sure about later versions) has an error in add-zsh-hook
58 # so the compatibility version is used there too.
59 if [[ $ZSH_VERSION != (4.3.<5->|4.<4->*|<5->*) ]]; then
60 # Provide add-zsh-hook which was added in 4.3.4.
61 fpath=(~/.zsh/functions/compatibility $fpath)
63 # Run all functions defined in the ${precmd,preexec,chpwd}_functions
66 for function in $precmd_functions; do
71 for function in $preexec_functions; do
76 for function in $chpwd_functions; do
82 # Autoload add-zsh-hook to add/remove zsh hook functions easily.
83 autoload -Uz add-zsh-hook
85 # Load zmv (zsh move) which is powerful to rename files.
91 # Use history and store it in ~/.zsh/history.
94 HISTFILE=~/.zsh/history
95 # Append to the history file instead of overwriting it and do it immediately
96 # when a command is executed.
98 setopt incappendhistory
99 # If the same command is run multiple times store it only once in the history.
100 setopt histignoredups
101 # Vim like completions of previous executed commands (also enter Vi-mode). If
102 # called at the beginning it just recalls old commands (like cursor up), if
103 # called after typing something, only lines starting with the typed are
104 # returned. Very useful to get old commands quickly. Thanks to Mikachu in #zsh
105 # on Freenode (2010-01-17 12:47) for the information how to a use function
107 zle -N my-vi-history-beginning-search-backward
108 my-vi-history-beginning-search-backward() {
109 local not_at_beginning_of_line
110 if [[ $CURSOR -ne 0 ]]; then
111 not_at_beginning_of_line=yes
114 zle history-beginning-search-backward
116 # Start Vi-mode and stay at the same position (Vi-mode moves one left,
119 if [[ -n $not_at_beginning_of_line ]]; then
123 bindkey "^P" my-vi-history-beginning-search-backward
124 bindkey -a "^P" history-beginning-search-backward # binding for Vi-mode
125 # Here only Vi-mode is necessary as ^P enters Vi-mode and ^N only makes sense
127 bindkey -a "^N" history-beginning-search-forward
132 # Use colorized output, necessary for prompts and completions.
133 autoload -U colors && colors
135 # Some shortcuts for colors.
136 local red="%{${fg[red]}%}"
137 local blue="%{${fg[blue]}%}"
138 local green="%{${fg[green]}%}"
139 local yellow="%{${fg[yellow]}%}"
140 local default="%{${fg[default]}%}"
142 # Set the default prompt. The current host and working directory is displayed,
143 # the exit code of the last command if it wasn't 0, the number of running jobs
146 # The prompt is in green and blue to make easily detectable, the error exit
147 # code in red and bold and the job count in yellow.
148 PROMPT="$green%B%m%b$default:$blue%B%~%b$default \
149 %(1j.$yellow%j$default.)%# \
150 %(?..($red%B%?%b$default%) )"
152 # vcs_info was added in 4.3.9 but it works in earlier versions too. So load it
153 # if the necessary files are available in ~/.zsh/functions/vcs_info (often a
154 # symbolic link to current checkout of Zsh's sources).
155 if [[ $ZSH_VERSION == (4.3.<9->|4.<4->*|<5->*) ||
156 -d ~/.zsh/functions/vcs_info ]]; then
157 # Update fpath to allow loading the vcs_info functions.
158 if [[ -d ~/.zsh/functions/vcs_info ]]; then
159 fpath=(~/.zsh/functions/vcs_info/
160 ~/.zsh/functions/vcs_info/Backends
164 # Allow substitutions and expansions in the prompt, necessary for
167 # Load vcs_info to display information about version control repositories.
168 autoload -Uz vcs_info
169 # Only look for git and mercurial repositories; the only I use.
170 zstyle ':vcs_info:*' enable git hg
171 # Check the repository for changes so they can be used in %u/%c (see
172 # below). This comes with a speed penalty for bigger repositories.
173 zstyle ':vcs_info:*' check-for-changes true
175 # Set style of vcs_info display. The current branch (green) and VCS (blue)
176 # is displayed. If there is an special action going on (merge, rebase)
177 # it's also displayed (red). Also display if there are unstaged or staged
179 if [[ $ZSH_VERSION == (4.3.<11->|4.<4->*|<5->*) ||
180 -d ~/.zsh/functions/vcs_info ]]; then
181 zstyle ':vcs_info:*' formats \
182 "($green%b%u%c$default:$blue%s$default)"
183 zstyle ':vcs_info:*' actionformats \
184 "($green%b%u%c$default/$red%a$default:$blue%s$default)"
186 # In older versions %u and %c are not defined yet and are not
187 # correctly expanded.
188 zstyle ':vcs_info:*' formats \
189 "($green%b$default:$blue%s$default)"
190 zstyle ':vcs_info:*' actionformats \
191 "($green%b$default/$red%a$default:$blue%s$default)"
193 # Set style for formats/actionformats when unstaged (%u) and staged (%c)
194 # changes are detected in the repository; check-for-changes must be set to
195 # true for this to work. Thanks to Bart Trojanowski
196 # (http://jukie.net/~bart/blog/pimping-out-zsh-prompt) for the idea
197 # (2010-03-11 00:20).
198 zstyle ':vcs_info:*' unstagedstr '¹'
199 zstyle ':vcs_info:*' stagedstr '²'
201 # Call vcs_info as precmd before every prompt.
205 add-zsh-hook precmd prompt_precmd
207 # Display the VCS information in the right prompt.
208 if [[ $ZSH_VERSION == (4.3.<9->|4.<4->*|<5->*) ]]; then
209 RPROMPT='${vcs_info_msg_0_}'
210 # There is a bug in Zsh below 4.3.9 which displays a wrong symbol when
211 # ${vcs_info_msg_0_} is empty. Provide a workaround for those versions,
212 # thanks to Frank Terbeck <ft@bewatermyfriend.org> for it.
214 RPROMPT='${vcs_info_msg_0_:- }'
218 unset red blue green yellow default
220 # When screen, xterm or rxvt is used set the name of the window to the
221 # currently running program.
223 # When a program is started preexec() sets the window's name to it; when it
224 # stops precmd() resets the window's name to 'zsh'.
226 # It works with screen, xterm and rxvt.
228 # If a command is run with sudo or if the shell is running as root then a ! is
229 # added at the beginning of the command to make this clear. If a command is
230 # running on a different computer with ssh a @ is added at the beginning. If
231 # screen is running on the remote machine instead of @screen @:hostname
232 # (hostname replaced by the machine's hostname) is displayed. This only works
233 # if the .zshrc on the server also uses this command.
234 if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
235 # Is set to a non empty value to reset the window name in the next
238 # Is set to a non empty value when the shell is running as root.
239 if [[ $(id -u) -eq 0 ]]; then
244 # Get the program name with its arguments.
245 local program_name=$1
247 # When sudo is used use real program name instead, but with an
248 # exclamation mark at the beginning (handled below).
250 if [[ $program_name == sudo* ]]; then
251 program_name=${program_name#sudo }
254 # Remove all arguments from the program name.
255 program_name=${program_name%% *}
257 # Ignore often used commands which are only running for a very short
258 # time. This prevents a "blinking" name when it's changed to "cd" for
259 # example and then some milliseconds later back to "zsh".
260 [[ $program_name == (cd*|ls|la|ll|clear|c) ]] && return
262 # Change my shortcuts so the real name of the program is displayed.
263 case $program_name in
278 # Add an exclamation mark at the beginning if running with sudo or if
279 # running zsh as root.
280 if [[ -n $program_sudo || -n $window_root ]]; then
281 program_name=!$program_name
284 # Add an at mark at the beginning if running through ssh on a
285 # different computer.
286 if [[ -n $SSH_CONNECTION ]]; then
287 program_name="@$program_name"
289 # If screen is running in SSH then display "@:hostname" as title
290 # in the term/outer screen.
291 if [[ $program_name == @screen ]]; then
292 program_name="@:${$(hostname)//.*/}"
296 # Set the window name to the currently running program.
297 window_title "$program_name"
299 # Tell precmd() to reset the window name when the program stops.
304 # Abort if no window name reset is necessary.
305 [[ -z $window_reset ]] && return
307 # Reset the window name to 'zsh'.
309 # If the function was called with an argument then reset the window
310 # name to '.zsh' (used by clear alias).
315 # Prepend prefixes like in window_preexec().
316 if [[ -n $SSH_CONNECTION ]]; then
317 window_title "@$name"
318 elif [[ -n $window_root ]]; then
319 window_title "!$name"
324 # Just reset the name, so no screen reset necessary for the moment.
328 # Sets the window title. Works with screen, xterm and rxvt.
329 if [[ $TERM == screen* ]]; then
333 elif [[ $TERM == xterm* || $TERM == rxvt* ]]; then
335 print -n "\e]2;$1\e\\"
339 # Add the preexec() and precmd() hooks.
340 add-zsh-hook preexec window_preexec
341 add-zsh-hook precmd window_precmd
345 # COMPLETION SETTINGS
347 # Load the complist module which provides additions to completion lists
348 # (coloring, scrollable).
349 zmodload zsh/complist
350 # Use new completion system, store dumpfile in ~/.zsh/cache to prevent
351 # cluttering of ~/. $fpath must be set before calling this. Thanks to Adlai in
352 # #zsh on Freenode (2009-08-07 21:05) for reminding me of the $fpath problem.
353 autoload -U compinit && compinit -d ~/.zsh/cache/zcompdump
355 # Use cache to speed up completions.
356 zstyle ':completion:*' use-cache on
357 zstyle ':completion:*' cache-path ~/.zsh/cache
359 # Complete arguments and fix spelling mistakes when possible.
360 zstyle ':completion:*' completer _complete _match _correct _approximate
362 # Make sure the list of possible completions is displayed after pressing <TAB>
364 setopt nolistambiguous
365 # Allow completions in the middle of a text, i.e. "/usr/bin/<TAB>whatever"
366 # completes like "/usr/bin/<TAB>". Useful when adding new options to commands.
367 bindkey "^I" expand-or-complete-prefix
368 # Try uppercase if the currently typed string doesn't match. This allows
369 # typing in lowercase most of the time and completion fixes the case.
370 zstyle ':completion:*' matcher-list '' 'm:{a-z}={A-Z}'
372 # Use ls like colors for completions.
373 zstyle ':completion:*' list-colors ${(s.:.)LS_COLORS}
375 # Make completion lists scrollable so "do you wish to see all n possibilities"
376 # is no longer displayed.
377 zstyle ':completion:*' list-prompt '%p'
378 # Display group name (like 'external command', 'alias', etc.) when there are
379 # multiple matches in bold.
380 zstyle ':completion:*' format ' %B%d%b:'
381 # Display different types of matches separately.
382 zstyle ':completion:*' group-name ''
384 # Ignore completion functions.
385 zstyle ':completion:*:functions' ignored-patterns '_*'
386 # Ignore parent directory.
387 zstyle ':completion:*:(cd|mv|cp):*' ignore-parents parent pwd
388 # When unsetting variables make sure every variable name is only suggested
390 zstyle ':completion:*:unset:*' ignore-line yes
391 # When working with Mercurial and Git don't complete the same file multiple
392 # times. Very useful when completing file names.
393 zstyle ':completion:*:(hg|git)*:*' ignore-line yes
396 # CUSTOM ALIASES AND FUNCTIONS
398 # If ^C is pressed while typing a command, add it to the history so it can be
399 # easily retrieved later and then abort like ^C normally does. This is useful
400 # when I want to abort an command to do something in between and then finish
401 # typing the command.
403 # Thanks to Vadim Zeitlin <vz-zsh@zeitlins.org> for a fix (--) so lines
404 # starting with - don't cause errors.
406 # Store the current buffer in the history.
407 zle && print -s -- $BUFFER
409 # Return the default exit code so Zsh aborts the current command.
413 # Colorize stderr. Very useful when looking for errors. Thanks to
414 # http://gentoo-wiki.com/wiki/Zsh for the basic script and Mikachu in #zsh on
415 # Freenode (2010-03-07 04:03) for some improvements (-r, printf). It's not yet
416 # perfect and doesn't work with some interactive stderr output, but in those
417 # cases the E alias can be used as workaround.
418 exec 2>>(while read -r line; do
419 printf '\e[91m%s\e[0m\n' "$line"
423 # Load aliases and similar functions also used by other shells.
424 if [[ -f ~/.shell/aliases ]]; then
428 # Make sure aliases are expanded when using sudo.
431 # Global aliases for often used commands in the command line.
433 alias -g L='E | less'
434 alias -g D='E | colordiff L'
441 # Make going up directories simple.
443 alias -g ....='../../..'
444 alias -g .....='../../../..'
446 # If the window naming feature is used (see above) then use ".zsh" (leading
447 # dot) as title name after running clear so it's clear to me that the window
448 # is empty. I open so much windows that I don't know in which I have something
449 # important. This helps me to remember which windows are empty (I run clear
450 # after I finished my work in a window).
451 if [[ -n $window_reset ]]; then
452 alias clear='clear; window_reset=yes; window_precmd reset'
455 # Display all branches (except stash) in gitk but only 200 commits as this is
456 # much faster. Also put in the background and disown. Thanks to sitaram in
457 # #git on Freenode (2009-04-20 15:51).
461 $(git rev-parse --symbolic-full-name --remotes --branches) \
465 # Same for tig (except the disown part as it's no GUI program).
469 $(git rev-parse --symbolic-full-name --remotes --branches) \
474 # OS SPECIFIC SETTINGS
476 if [[ $(uname) == Linux ]]; then
477 # Settings when creating Debian packages.
478 DEBEMAIL=simon@ruderich.org
480 DEBFULLNAME="Simon Ruderich"
483 elif [[ $(uname) == Darwin ]]; then # Mac OS X
484 # Store the current clipboard in CLIPBOARD before every command so it can
485 # be used in commands.
486 os_darwin_preexec() {
487 export CLIPBOARD="$(pbpaste)"
489 # Add the function as preexec hook.
490 add-zsh-hook preexec os_darwin_preexec
492 # Initialize CLIPBOARD so it's available for completion directly after
497 # Fetch current URL in clipboard with wget.
498 alias wnc='wget --no-proxy $CLIPBOARD'
502 # LOAD ADDITIONAL CONFIGURATION FILES
504 # Load rc file for current hostname (first part before a dot) or rc.local.
505 source_config ~/.zsh host rc ${$(hostname)//.*/}
510 # If not already in screen reattach to a running session or create a new one.
512 # screen* is necessary as `screen` uses screen.linux for example for a linux
513 # console which would otherwise cause an infinite loop.
514 if [[ $TERM != screen* && $TERM != 'dumb' ]]; then
515 # Get running detached sessions.
516 session=$(screen -list | grep 'Detached' | awk '{ print $1; exit }')
517 # Create a new session if none is running.
518 if [[ -z $session ]]; then
520 # Reattach to a running session.
527 source_debug "finished sourcing ~/.zsh/rc"