Installation

  1. Install the recommended font. Optional but highly recommended.
  2. Install Powerlevel10k for your plugin manager.
  3. Manual 👈 choose this if confused or uncertain
  4. Oh My Zsh
  5. Prezto
  6. Zim
  7. Antibody
  8. Antigen
  9. Zplug
  10. Zgen
  11. Zplugin
  12. Zinit
  13. Homebrew
  14. Arch Linux
  15. Restart Zsh.
  16. Type p10k configure if the configuration wizard doesn't start automatically.

Manual

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

Users in mainland China can use the official mirror on gitee.com for faster download.
中国大陆用户可以使用 gitee.com 上的官方镜像加速下载.

git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

This is the simplest kind of installation and it works even if you are using a plugin manager. Just make sure to disable the current theme in your plugin manager. See troubleshooting for help.

Oh My Zsh

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Users in mainland China can use the official mirror on gitee.com for faster download.
中国大陆用户可以使用 gitee.com 上的官方镜像加速下载.

git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Set ZSH_THEME="powerlevel10k/powerlevel10k" in ~/.zshrc.

Prezto

Add zstyle :prezto:module:prompt theme powerlevel10k to ~/.zpreztorc.

Zim

Add zmodule romkatv/powerlevel10k to ~/.zimrc and run zimfw install.

Antibody

Add antibody bundle romkatv/powerlevel10k to ~/.zshrc.

Antigen

Add antigen theme romkatv/powerlevel10k to ~/.zshrc. Make sure you have antigen apply somewhere after it.

Zplug

Add zplug romkatv/powerlevel10k, as:theme, depth:1 to ~/.zshrc.

Zgen

Add zgen load romkatv/powerlevel10k powerlevel10k to ~/.zshrc.

Zplugin

Add zplugin ice depth=1; zplugin light romkatv/powerlevel10k to ~/.zshrc.

The use of depth=1 ice is optional. Other types of ice are neither recommended nor officially supported by Powerlevel10k.

Zinit

Add zinit ice depth=1; zinit light romkatv/powerlevel10k to ~/.zshrc.

The use of depth=1 ice is optional. Other types of ice are neither recommended nor officially supported by Powerlevel10k.

Homebrew

brew install romkatv/powerlevel10k/powerlevel10k
echo 'source /usr/local/opt/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

Arch Linux

yay -S --noconfirm zsh-theme-powerlevel10k-git
echo 'source /usr/share/zsh-theme-powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

zsh-theme-powerlevel10k-git referenced above is the official Powerlevel10k package.

There is also zsh-theme-powerlevel10k community package. Historicaly, it has been breaking often and for extended periods of time. Do not use it.