powerlevel10k/mkdocs/installation.md

Installation

1. Install the recommended font. Optional but highly recommended.
2. Install Powerlevel10k for your plugin manager.
   • Manual 👈 choose this if confused or uncertain
   • Oh My Zsh
   • Prezto
   • Zim
   • Antibody
   • Antigen
   • Zplug
   • Zgen
   • Zplugin
   • Zinit
   • Homebrew
   • Arch Linux
3. Restart Zsh.
4. 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.