# Installation 1. Install [the recommended font](#recommended-font-meslo-nerd-font-patched-for-powerlevel10k). _Optional but highly recommended._ 2. Install Powerlevel10k for your plugin manager. - [Manual](#manual) 👈 **choose this if confused or uncertain** - [Oh My Zsh](#oh-my-zsh) - [Prezto](#prezto) - [Zim](#zim) - [Antibody](#antibody) - [Antigen](#antigen) - [Zplug](#zplug) - [Zgen](#zgen) - [Zplugin](#zplugin) - [Zinit](#zinit) - [Homebrew](#homebrew) - [Arch Linux](#arch-linux) 3. Restart Zsh. 4. Type `p10k configure` if the configuration wizard doesn't start automatically. ## Manual ```zsh 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 上的官方镜像加速下载. ```zsh 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](#cannot-make-powerlevel10k-work-with-my-plugin-manager) for help. ## Oh My Zsh ```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 上的官方镜像加速下载. ```zsh 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 ```zsh brew install romkatv/powerlevel10k/powerlevel10k echo 'source /usr/local/opt/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc ``` ## Arch Linux ```zsh yay -S --noconfirm zsh-theme-powerlevel10k-git echo 'source /usr/share/zsh-theme-powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc ``` [zsh-theme-powerlevel10k-git](https://aur.archlinux.org/packages/zsh-theme-powerlevel10k-git/) referenced above is the official Powerlevel10k package. There is also [zsh-theme-powerlevel10k](https://www.archlinux.org/packages/community/x86_64/zsh-theme-powerlevel10k/) community package. Historicaly, [it has been breaking often and for extended periods of time](https://github.com/romkatv/powerlevel10k/pull/786). **Do not use it.**