# 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.

#### Search

From here you can search these documents. Enter your search terms below.

#### Keyboard Shortcuts

Keys | Action
--- | ---
`?` | Open this help
`n` | Next page
`p` | Previous page
`s` | Search