@ -2,11 +2,6 @@
[](
https://gitter.im/powerlevel10k/community?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge)
- **THE PROJECT HAS VERY LIMITED SUPPORT**
- **NO NEW FEATURES ARE IN THE WORKS**
- **MOST BUGS WILL GO UNFIXED**
- **HELP REQUESTS WILL BE IGNORED**
Powerlevel10k is a theme for Zsh. It emphasizes [speed ](#uncompromising-performance ),
[flexibility ](#extremely-customizable ) and [out-of-the-box experience ](#configuration-wizard ).
@ -220,8 +215,9 @@ Configs created by `p10k configure` enable show on command for several prompt se
Here's the relevant parameter for kubernetes context:
```zsh
# Show prompt segment "kubecontext" only when the command you are typing invokes one of these tools.
typeset -g POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens'
# Show prompt segment "kubecontext" only when the command you are typing
# invokes kubectl, helm, kubens, kubectx, oc, istioctl, kogito, k9s, helmfile, flux, fluxctl or stern.
typeset -g POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens|kubectx|oc|istioctl|kogito|k9s|helmfile|flux|fluxctl|stern'
```
To customize when different prompt segments are shown, open `~/.p10k.zsh` , search for
@ -305,85 +301,75 @@ To ~~ridiculous~~ extravagant:
### Batteries included
Powerlevel10k comes with dozens of built-in high quality prompt segments that can display
information from a variety of sources. When you run `p10k configure` and choose any style
except [Pure ](#pure-compatibility ), many of these segments get enabled by
default while others can be manually enabled by opening `~/.p10k.zsh` and uncommenting them.
You can enable as many segments as you like. It won't slow down your prompt or Zsh startup.
Powerlevel10k comes with dozens of built-in high quality segments. When you run `p10k configure`
and choose any style except [Pure ](#pure-compatibility ), many of these segments get enabled by
default while others be manually enabled by opening `~/.p10k.zsh` and uncommenting them. You can
enable as many segments as you like. It won't slow down your prompt or Zsh startup.
| Segment | Meaning |
|--------:|---------|
| `anaconda` | virtual environment from [conda ](https://conda.io/ ) |
| `asdf` | tool versions from [asdf ](https://github.com/asdf-vm/asdf ) |
| `aws` | [aws profile ](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html ) |
| `aws_eb_env` | [aws elastic beanstalk ](https://aws.amazon.com/elasticbeanstalk/ ) environment |
| `azure` | [azure ](https://docs.microsoft.com/en-us/cli/azure ) account name |
| `background_jobs` | presence of background jobs |
| `battery` | internal battery state and charge level (yep, batteries *literally* included) |
| `command_execution_time` | duration (wall time) of the last command |
| `context` | user@hostname |
| `cpu_arch` | CPU architecture |
| `os_icon` | your OS logo (apple for macOS, swirl for debian, etc.) |
| `dir` | current working directory |
| `vcs` | Git repository status |
| `prompt_char` | multi-functional prompt symbol; changes depending on vi mode: `❯ , `❮ , `V` , `▶` for insert, command, visual and replace mode respectively; turns red on error |
| `context` | user@hostname |
| `status` | exit code of the last command |
| `command_execution_time` | duration (wall time) of the last command |
| `background_jobs` | presence of background jobs |
| `time` | current time |
| `direnv` | [direnv ](https://direnv.net/ ) status |
| `disk_usage` | disk usage |
| `dotnet_version` | [dotnet ](https://dotnet.microsoft.com ) version |
| `fvm` | flutter environment from [fvm ](https://github.com/leoafarias/fvm ) |
| `gcloud` | [google cloud ](https://cloud.google.com/ ) cli account and project |
| ` asdf` | tool versions from [asdf ](https://github.com/asdf-vm/asdf ) |
| ` virtualenv` | python environment from [venv ](https://docs.python.org/3/library/venv.html ) |
| ` anaconda` | virtual environment from [conda ](https://conda.io/ ) |
| ` pyenv` | python environment from [pyenv ](https://github.com/pyenv/pyenv ) |
| `goenv` | go environment from [goenv ](https://github.com/syndbg/goenv ) |
| `google_app_cred` | [google application credentials ](https://cloud.google.com/docs/authentication/production ) |
| `go_version` | [go ](https://golang.org ) version |
| `haskell_stack` | haskell version from [stack ](https://haskellstack.org/ ) |
| `ip` | IP address and bandwidth usage for a specified network interface |
| `java_version` | [java ](https://www.java.com/ ) version |
| `jenv` | java environment from [jenv ](https://github.com/jenv/jenv ) |
| `kubecontext` | current [kubernetes ](https://kubernetes.io/ ) context |
| `laravel_version` | [laravel php framework ](https://laravel.com/ ) version |
| `load` | CPU load |
| `luaenv` | lua environment from [luaenv ](https://github.com/cehoffman/luaenv ) |
| `midnight_commander` | [midnight commander ](https://midnight-commander.org/ ) shell |
| `nix_shell` | [nix shell ](https://nixos.org/nixos/nix-pills/developing-with-nix-shell.html ) indicator |
| `nnn` | [nnn ](https://github.com/jarun/nnn ) shell |
| `lf` | [lf ](https://github.com/gokcehan/lf ) shell |
| `chezmoi_shell` | [chezmoi ](https://www.chezmoi.io/ ) shell |
| `nodeenv` | node.js environment from [nodeenv ](https://github.com/ekalinin/nodeenv ) |
| `nodenv` | node.js environment from [nodenv ](https://github.com/nodenv/nodenv ) |
| `node_version` | [node.js ](https://nodejs.org/ ) version |
| `nordvpn` | [nordvpn ](https://nordvpn.com/ ) connection status |
| `nvm` | node.js environment from [nvm ](https://github.com/nvm-sh/nvm ) |
| `os_icon` | your OS logo (apple for macOS, swirl for debian, etc.) |
| `package` | `name@version` from [package.json ](https://docs.npmjs.com/files/package.json ) |
| `per_directory_history` | Oh My Zsh [per-directory-history ](https://github.com/jimhester/per-directory-history ) local/global indicator |
| `perlbrew` | perl version from [perlbrew ](https://github.com/gugod/App-perlbrew ) |
| `phpenv` | php environment from [phpenv ](https://github.com/phpenv/phpenv ) |
| `php_version` | [php ](https://www.php.net/ ) version |
| `plenv` | perl environment from [plenv ](https://github.com/tokuhirom/plenv ) |
| `prompt_char` | multi-functional prompt symbol; changes depending on vi mode: `❯ , `❮ , `V` , `▶` for insert, command, visual and replace mode respectively; turns red on error |
| `proxy` | system-wide http/https/ftp proxy |
| `public_ip` | public IP address |
| `pyenv` | python environment from [pyenv ](https://github.com/pyenv/pyenv ) |
| `ram` | free RAM |
| `ranger` | [ranger ](https://github.com/ranger/ranger ) shell |
| `yazi` | [yazi ](https://github.com/sxyazi/yazi ) shell |
| `nodeenv` | node.js environment from [nodeenv ](https://github.com/ekalinin/nodeenv ) |
| `rbenv` | ruby environment from [rbenv ](https://github.com/rbenv/rbenv ) |
| `rust_version` | [rustc ](https://www.rust-lang.org ) version |
| `rvm` | ruby environment from [rvm ](https://rvm.io ) |
| `scalaenv` | scala version from [scalaenv ](https://github.com/scalaenv/scalaenv ) |
| `status` | exit code of the last command |
| `swap` | used swap |
| `taskwarrior` | [taskwarrior ](https://taskwarrior.org/ ) task count |
| `fvm` | flutter environment from [fvm ](https://github.com/leoafarias/fvm ) |
| `luaenv` | lua environment from [luaenv ](https://github.com/cehoffman/luaenv ) |
| `jenv` | java environment from [jenv ](https://github.com/jenv/jenv ) |
| `plenv` | perl environment from [plenv ](https://github.com/tokuhirom/plenv ) |
| `phpenv` | php environment from [phpenv ](https://github.com/phpenv/phpenv ) |
| `haskell_stack` | haskell version from [stack ](https://haskellstack.org/ ) |
| `node_version` | [node.js ](https://nodejs.org/ ) version |
| `go_version` | [go ](https://golang.org ) version |
| `rust_version` | [rustc ](https://www.rust-lang.org ) version |
| `dotnet_version` | [dotnet ](https://dotnet.microsoft.com ) version |
| `php_version` | [php ](https://www.php.net/ ) version |
| `laravel_version` | [laravel php framework ](https://laravel.com/ ) version |
| `java_version` | [java ](https://www.java.com/ ) version |
| `package` | `name@version` from [package.json ](https://docs.npmjs.com/files/package.json ) |
| `kubecontext` | current [kubernetes ](https://kubernetes.io/ ) context |
| `terraform` | [terraform ](https://www.terraform.io ) workspace |
| `terraform_version` | [terraform ](https://www.terraform.io ) version |
| `time` | current time |
| `timewarrior` | [timewarrior ](https://timewarrior.net/ ) tracking status |
| `todo` | [todo ](https://github.com/todotxt/todo.txt-cli ) items |
| `toolbox` | [toolbox ](https://github.com/containers/toolbox ) name |
| `vcs` | Git repository status |
| `aws` | [aws profile ](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html ) |
| `aws_eb_env` | [aws elastic beanstalk ](https://aws.amazon.com/elasticbeanstalk/ ) environment |
| `azure` | [azure ](https://docs.microsoft.com/en-us/cli/azure ) account name |
| `gcloud` | [google cloud ](https://cloud.google.com/ ) cli account and project |
| `google_app_cred` | [google application credentials ](https://cloud.google.com/docs/authentication/production ) |
| `nordvpn` | [nordvpn ](https://nordvpn.com/ ) connection status |
| `ranger` | [ranger ](https://github.com/ranger/ranger ) shell |
| `nnn` | [nnn ](https://github.com/jarun/nnn ) shell |
| `xplr` | [xplr ](https://github.com/sayanarijit/xplr ) shell |
| `vim_shell` | [vim ](https://www.vim.org/ ) shell (`:sh`) |
| `virtualenv` | python environment from [venv ](https://docs.python.org/3/library/venv.html ) |
| `vi_mode` | vi mode (you don't need this if you've enabled prompt_char) |
| `midnight_commander` | [midnight commander ](https://midnight-commander.org/ ) shell |
| `nix_shell` | [nix shell ](https://nixos.org/nixos/nix-pills/developing-with-nix-shell.html ) indicator |
| `todo` | [todo ](https://github.com/todotxt/todo.txt-cli ) items |
| `timewarrior` | [timewarrior ](https://timewarrior.net/ ) tracking status |
| `taskwarrior` | [taskwarrior ](https://taskwarrior.org/ ) task count |
| `vpn_ip` | virtual private network indicator |
| `ip` | IP address and bandwidth usage for a specified network interface |
| `load` | CPU load |
| `disk_usage` | disk usage |
| `ram` | free RAM |
| `swap` | used swap |
| `public_ip` | public IP address |
| `proxy` | system-wide http/https/ftp proxy |
| `wifi` | WiFi speed |
| `xplr` | [xplr ](https://github.com/sayanarijit/xplr ) shell |
| ` battery` | internal battery state and charge level (yep, batteries *literally* included) |
### Extensible
@ -404,11 +390,6 @@ it out of the box.
Type `p10k help segment` for reference.
*Note*: If you modify `POWERLEVEL9K_*` parameters in an already initialized interactive shell (as
opposed to editing `~/.p10k.zsh` ), the changes might not be immediately effective. To apply the
modifications, invoke `p10k reload` . Setting `POWERLEVEL9K_DISABLE_HOT_RELOAD=false` eliminates the
necessity for `p10k reload` but results in a marginally slower prompt.
*Tip*: Prefix names of your own segments with `my_` to avoid clashes with future versions of
Powerlevel10k.
@ -419,18 +400,13 @@ Powerlevel10k.
- [Prezto ](#prezto )
- [Zim ](#zim )
- [Antibody ](#antibody )
- [Antidote ](#antidote )
- [Antigen ](#antigen )
- [Zplug ](#zplug )
- [Zgen ](#zgen )
- [Zplugin ](#zplugin )
- [Zinit ](#zinit )
- [Zi ](#zi )
- [Zap ](#zap )
- [Homebrew ](#homebrew )
- [Arch Linux ](#arch-linux )
- [Alpine Linux ](#alpine-linux )
- [Fig ](#fig )
### Manual
@ -439,8 +415,8 @@ git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc
```
Users in China can use the official mirror on gitee.com for faster download.< br >
中国用户可以使用 gitee.com 上的官方镜像加速下载.
Users in mainland China can use the official mirror on gitee.com for faster download.< br >
中国大陆 用户可以使用 gitee.com 上的官方镜像加速下载.
```zsh
git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ~/powerlevel10k
@ -457,8 +433,8 @@ make sure to disable the current theme in your plugin manager. See
```zsh
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
```
Users in China can use the official mirror on gitee.com for faster download.< br >
中国用户可以使用 gitee.com 上的官方镜像加速下载.
Users in mainland China can use the official mirror on gitee.com for faster download.< br >
中国大陆 用户可以使用 gitee.com 上的官方镜像加速下载.
```zsh
git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
@ -477,10 +453,6 @@ Add `zmodule romkatv/powerlevel10k --use degit` to `~/.zimrc` and run `zimfw ins
Add `antibody bundle romkatv/powerlevel10k` to `~/.zshrc` .
### Antidote
Add `romkatv/powerlevel10k` to `~/.zsh_plugins.txt` .
### Antigen
Add `antigen theme romkatv/powerlevel10k` to `~/.zshrc` . Make sure you have `antigen apply`
@ -508,22 +480,11 @@ 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.
### Zi
Add `zi ice depth=1; zi 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.
### Zap
Add `plug "romkatv/powerlevel10k"` to `~/.zshrc` .
### Homebrew
```zsh
brew install powerlevel10k
echo "source $(brew --prefix)/share /powerlevel10k/powerlevel10k.zsh-theme" >>~/.zshrc
brew install romkatv/powerlevel10k/powerlevel10k
echo "source $(brew --prefix)/opt/powerlevel10k/powerlevel10k.zsh-theme" >>~/.zshrc
```
### Arch Linux
@ -537,23 +498,10 @@ echo 'source /usr/share/zsh-theme-powerlevel10k/powerlevel10k.zsh-theme' >>~/.zs
referenced above is the official Powerlevel10k package.
There is also [zsh-theme-powerlevel10k](
https://www.archlinux.org/packages/extra/x86_64/zsh-theme-powerlevel10k/) package.
https://www.archlinux.org/packages/community/x86_64/zsh-theme-powerlevel10k/) community package.
Historically, [it has been breaking often and for extended periods of time](
https://github.com/romkatv/powerlevel10k/pull/786). **Do not use it.**
### Alpine Linux
```zsh
apk add zsh zsh-theme-powerlevel10k
mkdir -p ~/.local/share/zsh/plugins
ln -s /usr/share/zsh/plugins/powerlevel10k ~/.local/share/zsh/plugins/
```
### Fig
Follow the instructions on
[this page ](https://fig.io/plugins/other/powerlevel10k ).
## Configuration
- [For new users ](#for-new-users )
@ -672,10 +620,11 @@ If you are using a different terminal, proceed with manual font installation.
*Custom font* under *Text Appearance* and select `MesloLGS NF Regular` .
- **Windows Console Host** (the old thing): Click the icon in the top left corner, then
*Properties → Font* and set *Font* to `MesloLGS NF` .
- **Windows Terminal** by Microsoft (the new thing): Open *Settings* (< kbd > Ctrl+,</ kbd > ), click
either on the selected profile under *Profiles* or on *Defaults* , click *Appearance* and set
*Font face* to `MesloLGS NF` .
- **Conemu** : Open *Setup → General → Fonts* and set *Main console font* to `MesloLGS NF` .
- **Windows Terminal** by Microsoft (the new thing): Open `settings.json` (< kbd > Ctrl+Shift+,</ kbd > ),
search for `fontFace` and set the value to `MesloLGS NF` for every profile. If you don't find
`fontFace` , add it under *profiles → defaults* . See [this settings file](
https://raw.githubusercontent.com/romkatv/dotfiles-public/aba0e6c4657d705ed6c344d700d659977385f25c/dotfiles/microsoft-terminal-settings.json)
for example.
- **IntelliJ** (and other IDEs by Jet Brains): Open *IDE → Edit → Preferences → Editor →
Color Scheme → Console Font*. Select *Use console font instead of the default* and set the font
name to `MesloLGS NF` .
@ -683,7 +632,7 @@ If you are using a different terminal, proceed with manual font installation.
*Meslo Nerd Font* .
- **Blink** : Type `config` , go to *Appearance* , tap *Add a new font* , tap *Open Gallery* , select
*MesloLGS NF.css* , tap *import* and type `exit` in the home view to reload the font.
- **T abby** (formerly **T erminus**) : Open *Settings → Appearance* and set *Font* to `MesloLGS NF` .
- **T erminus**: Open *Settings → Appearance* and set *Font* to `MesloLGS NF` .
- **Terminator** : Open *Preferences* using the context menu. Under *Profiles* select the *General*
tab (should be selected already), uncheck *Use the system fixed width font* (if not already)
and select `MesloLGS NF Regular` . Exit the Preferences dialog by clicking *Close* .
@ -691,9 +640,7 @@ If you are using a different terminal, proceed with manual font installation.
tab, uncheck *Use the system fixed width font* (if not already) and select `MesloLGS NF Regular` .
Exit the Preferences dialog by clicking *Close* .
- **MobaXterm** : Open *Settings* → *Configuration* → *Terminal* → (under *Terminal look and feel* )
and change *Font* to `MesloLGS NF` . If you have *sessions* , you need to change the font in each
of them through *Settings* → right click on an individual session → *Edit Session* → *Terminal
Settings* → *Font settings* .
and change *Font* to `MesloLGS NF` .
- **Asbrú Connection Manager** : Open *Preferences → Local Shell Options → Look and Feel* , enable
*Use these personal options* and change *Font:* under *Terminal UI* to `MesloLGS NF Regular` .
To change the font for the remote host connections, go to *Preferences → Terminal Options →
@ -703,15 +650,12 @@ If you are using a different terminal, proceed with manual font installation.
- **Yakuake** : Click *≡* → *Manage Profiles* → *New* → *Appearance* . Click *Choose* next to the
*Font* dropdown, select `MesloLGS NF` and click *OK* . Click *OK* to save the profile. Select the
new profile and click *Set as Default* .
- **Alacritty** : Create or open `~/.config/alacritty/alacritty.toml` and add the following
section to it:
```toml
[font.normal]
family = "MesloLGS NF"
```
- **foot** : Create or open `~/.config/foot/foot.ini` and add the following section to it:
```ini
font=MesloLGS NF:size=12
- **Alacritty** : Create or open `~/.config/alacritty/alacritty.yml` and add the following section
to it:
```yaml
font:
normal:
family: "MesloLGS NF"
```
- **kitty** : Create or open `~/.config/kitty/kitty.conf` and add the following line to it:
```text
@ -733,53 +677,8 @@ If you are using a different terminal, proceed with manual font installation.
```text
URxvt.font: xft:MesloLGS NF:size=11
```
You can adjust the font size to your preference. After changing the config run
`xrdb ~/.Xresources` to reload it. The new config is applied to all new terminals.
- **xterm** : Create or open `~/.Xresources` and add the following line to it:
```text
xterm*faceName: MesloLGS NF
```
After changing the config run `xrdb ~/.Xresources` to reload it. The new config is applied to
all new terminals.
- **Zed** : Open `~/.config/zed/settings.json` and set `terminal.font_family` to `"MesloLGS NF"` .
```jsonc
{
"terminal": {
"font_family": "MesloLGS NF"
},
// Other settings.
}
```
- Crostini (Linux on Chrome OS): Open
chrome-untrusted://terminal/html/nassh_preferences_editor.html, set *Text font family* to
`'MesloLGS NF'` (including the quotes) and *Custom CSS (inline text)* to the following:
```css
@font -face {
font-family: "MesloLGS NF";
src: url("https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/MesloLGS%20NF%20Regular.ttf");
font-weight: normal;
font-style: normal;
}
@font -face {
font-family: "MesloLGS NF";
src: url("https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/MesloLGS%20NF%20Bold.ttf");
font-weight: bold;
font-style: normal;
}
@font -face {
font-family: "MesloLGS NF";
src: url("https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/MesloLGS%20NF%20Italic.ttf");
font-weight: normal;
font-style: italic;
}
@font -face {
font-family: "MesloLGS NF";
src: url("https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/MesloLGS%20NF%20Bold%20Italic.ttf");
font-weight: bold;
font-style: italic;
}
```
**_CAVEAT_** : If you open the normal terminal preferences these settings will be overwritten.
You can adjust the font size to your preference. After changing the configuration use `xrdb ~/.Xresources` to reload the config.
The new config is applied for all new terminals.
1. Run `p10k configure` to generate a new `~/.p10k.zsh` . The old config may work
incorrectly with the new font.
@ -789,7 +688,7 @@ PR to expand the list!_
## Try it in Docker
Try Powerlevel10k in Docker. You can safely make any changes to the file system while trying out
the theme. Once you exit Zsh, the container is deleted.
the theme. Once you exit Zsh, the image is deleted.
```zsh
docker run -e TERM -e COLORTERM -e LC_ALL=C.UTF-8 -it --rm alpine sh -uec '
@ -847,22 +746,18 @@ Powerlevel10k is released under the
The command to update Powerlevel10k depends on how it was installed.
| Installation | Update command |
|------------------------------- |-------------------------------------------------------------|
|---------------------------|-------------------------------------------------------------|
| [Manual ](#manual ) | `git -C ~/powerlevel10k pull` |
| [Oh My Zsh ](#oh-my-zsh ) | `git -C ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k pull` |
| [Prezto ](#prezto ) | `zprezto-update` |
| [Zim ](#zim ) | `zimfw update` |
| [Antigen ](#antigen ) | `antigen update` |
| [Antidote ](#antidote ) | `antidote update` |
| [Zplug ](#zplug ) | `zplug update` |
| [Zgen ](#zgen ) | `zgen update` |
| [Zplugin ](#zplugin ) | `zplugin update` |
| [Zinit ](#zinit ) | `zinit update` |
| [Zi ](#zi ) | `zi update` |
| [Zap ](#zap ) | `zap update` |
| [Homebrew ](#homebrew ) | `brew update && brew upgrade` |
| [Arch Linux ](#arch-linux ) | `yay -S --noconfirm zsh-theme-powerlevel10k-git` |
| [Alpine Linux ](#alpine-linux ) | `apk update && apk upgrade` |
**IMPORTANT**: Restart Zsh after updating Powerlevel10k. [Do not use `source ~/.zshrc` ](
#weird -things-happen-after-typing-source-zshrc).
@ -901,22 +796,18 @@ The command to update Powerlevel10k depends on how it was installed.
Refer to the [installation instructions ](#installation ) if you need a reminder.
| Installation | Uninstall command |
|------------------------------- |------------------------------------------------------------------|
|---------------------------|------------------------------------------------------------------|
| [Manual ](#manual ) | `rm -rf ~/powerlevel10k` |
| [Oh My Zsh ](#oh-my-zsh ) | `rm -rf -- ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k` |
| [Prezto ](#prezto ) | n/a |
| [Zim ](#zim ) | `zimfw uninstall` |
| [Antigen ](#antigen ) | `antigen purge romkatv/powerlevel10k` |
| [Antidote ](#antidote ) | `antidote purge romkatv/powerlevel10k` |
| [Zplug ](#zplug ) | `zplug clean` |
| [Zgen ](#zgen ) | `zgen reset` |
| [Zplugin ](#zplugin ) | `zplugin delete romkatv/powerlevel10k` |
| [Zinit ](#zinit ) | `zinit delete romkatv/powerlevel10k` |
| [Zi ](#zi ) | `zi delete romkatv/powerlevel10k` |
| [Zap ](#zap ) | `zsh -ic 'zap clean'` |
| [Homebrew ](#homebrew ) | `brew uninstall powerlevel10k` |
| [Homebrew ](#homebrew ) | `brew uninstall powerlevel10k; brew untap romkatv/powerlevel10k` |
| [Arch Linux ](#arch-linux ) | `yay -R --noconfirm zsh-theme-powerlevel10k-git` |
| [Alpine Linux ](#alpine-linux ) | `apk del zsh-theme-powerlevel10k` |
6. Restart Zsh. [Do not use `source ~/.zshrc` ](#weird-things-happen-after-typing-source-zshrc ).
7. Delete Powerlevel10k cache files.
```zsh
@ -987,8 +878,6 @@ Powerlevel10k does not affect:
- Prompt parameters other than `PS1` and `RPS1` .
- Zsh options other than those [related to prompt](
http://zsh.sourceforge.net/Doc/Release/Options.html#Prompting).
- The set of available commands. Powerlevel10k does not install any new commands
with the only exception of `p10k` .
### I'm using Powerlevel9k with Oh My Zsh. How do I migrate?
@ -1156,7 +1045,6 @@ feature:master wip ⇣42⇡42 ⇠42⇢42 *42 merge ~42 +42 !42 ?42
| `feature` | current branch; replaced with `#tag` or `@commit` if not on a branch | `git status --ignore-submodules=dirty` |
| `master` | remote tracking branch; only shown if different from local branch | `git rev-parse --abbrev-ref --symbolic-full-name @{upstream}` |
| `wip` | the latest commit's summary contains "wip" or "WIP" | `git show --pretty=%s --no-patch HEAD` |
| `=` | up to date with the remote (neither ahead nor behind) | `git rev-list --count HEAD...@{upstream}` |
| `⇣42` | this many commits behind the remote | `git rev-list --right-only --count HEAD...@{upstream}` |
| `⇡42` | this many commits ahead of the remote | `git rev-list --left-only --count HEAD...@{upstream}` |
| `⇠42` | this many commits behind the push remote | `git rev-list --right-only --count HEAD...@{push}` |
@ -1208,7 +1096,7 @@ completes, Powerlevel10k refreshes prompt with new information, this time with c
When using *Rainbow* style, Git status is displayed as black on grey while it's still being
computed. Depending on the terminal color palette, this may be difficult to read. In this case you
might want to change the background color to something light er for more contrast. To do that, open
might want to change the background color to something ligher for more contrast. To do that, open
`~/.p10k.zsh` , search for `POWERLEVEL9K_VCS_LOADING_BACKGROUND` , uncomment it if it's commented out,
and change the value.
@ -1261,9 +1149,9 @@ Prompt segments can be configured to be shown only when the current command you
a relevant tool.
```zsh
# Show prompt segment "kubecontext" only when the command you are typing invokes
# invokes kubectl, helm, or kubens .
typeset -g POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens'
# Show prompt segment "kubecontext" only when the command you are typing
# invokes kubectl, helm, kubens, kubectx, oc, istioctl, kogito, k9s, helmfile, flux, fluxctl or stern .
typeset -g POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens|kubectx|oc|istioctl|kogito|k9s|helmfile|flux|fluxctl|stern '
```
Configs created by `p10k configure` may contain parameters of this kind. To customize when different
@ -1279,7 +1167,7 @@ function kube-toggle() {
if (( ${+POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND} )); then
unset POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND
else
POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens'
POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens|kubectx|oc|istioctl|kogito|k9s|helmfile|flux|fluxctl|stern '
fi
p10k reload
if zle; then
@ -1332,28 +1220,15 @@ terminals. Many terminals also support customization of these colors through col
Type `source ~/.p10k.zsh` to apply your changes to the current Zsh session.
To see how different numbered colors look in your terminal, run the following command:
To see how different colors look in your terminal, run the following command:
```zsh
for i in {0..255}; do print -Pn "%K{$i} %k%F{$i}${(l:3::0:)i}%f " ${${(M)$((i%6)):#3}:+$'\n'}; done
```
If your terminal supports truecolor, you can use 24-bit colors in the `#RRGGBB` format in addition
to the numbered colors.
```zsh
typeset -g POWERLEVEL9K_TIME_FOREGROUND='#FF0000'
```
*Related:*
- [Directory is difficult to see in prompt when using Rainbow style.](
#directory -is-difficult-to-see-in-prompt-when-using-rainbow-style)
- [Incorrect foreground color in VSCode Terminal. ](#incorrect-foreground-color-in-vscode-terminal )
By default, VSCode Terminal may arbitrarily replace the foreground color of your choice with a
different color. This behavior can be
[turned off ](https://code.visualstudio.com/docs/terminal/appearance#_minimum-contrast-ratio ) in
VSCode settings.
### Why does Powerlevel10k spawn extra processes?
@ -1484,7 +1359,7 @@ https://www.reddit.com/r/zsh/comments/eg49ff/powerlevel10k_prompt_history_exit_c
### What is the minimum supported Zsh version?
Zsh 5.3 or newer should work. Fast startup requires Zsh >= 5.4.
Zsh 5.1 or newer should work. Fast startup requires Zsh >= 5.4.
### How were these screenshots and animated gifs created?
@ -1525,7 +1400,6 @@ Powerlevel10k are released. This may change in the future but not soon.
## Troubleshooting
- [`[oh-my-zsh] theme 'powerlevel10k/powerlevel10k' not found`](#oh-my-zsh-theme-powerlevel10kpowerlevel10k-not-found)
- [Question mark in prompt ](#question-mark-in-prompt )
- [Icons, glyphs or powerline symbols don't render ](#icons-glyphs-or-powerline-symbols-dont-render )
- [Sub-pixel imperfections around powerline symbols ](#sub-pixel-imperfections-around-powerline-symbols )
@ -1543,32 +1417,9 @@ Powerlevel10k are released. This may change in the future but not soon.
- [Transient prompt stops working after some time ](#transient-prompt-stops-working-after-some-time )
- [Cannot make Powerlevel10k work with my plugin manager ](#cannot-make-powerlevel10k-work-with-my-plugin-manager )
- [Directory is difficult to see in prompt when using Rainbow style ](#directory-is-difficult-to-see-in-prompt-when-using-rainbow-style )
- [Incorrect foreground color in VSCode Terminal. ](#incorrect-foreground-color-in-vscode-terminal )
- [Horrific mess when resizing terminal window ](#horrific-mess-when-resizing-terminal-window )
- [Icons cut off in Konsole ](#icons-cut-off-in-konsole )
- [Arch Linux logo has a dot in the bottom right corner ](#arch-linux-logo-has-a-dot-in-the-bottom-right-corner )
- [Incorrect git status in prompt ](#incorrect-git-status-in-prompt )
### `[oh-my-zsh] theme 'powerlevel10k/powerlevel10k' not found`
When opening a terminal, or starting zsh manually, you may encounter this error message:
```text
[oh-my-zsh] theme 'powerlevel10k/powerlevel10k' not found
```
1. First, run `typeset -p P9K_VERSION` to check whether Powerlevel10k has been loaded.
- If `typeset -p P9K_VERSION` succeeds and prints something like `typeset P9K_VERSION=1.19.14`
(the version could be different), remove the following line from `~/.zshrc` :
```zsh
ZSH_THEME="powerlevel10k/powerlevel10k"
```
- If `typeset -p P9K_VERSION` fails with the error `typeset: no such variable: P9K_VERSION` , run
the following command:
```zsh
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
```
2. Restart Zsh with `exec zsh` .
### Question mark in prompt
@ -1753,15 +1604,10 @@ and make sure that `TERM` environment variable is set correctly. Verify with
If there is no UTF-8 locale on the system, configuration wizard won't offer prompt styles that use
Unicode characters. *Fix* : Install a UTF-8 locale. Verify with `locale -a` .
Another case in which configuration wizard may not offer Unicode prompt styles is when the
`MULTIBYTE` shell option is disabled. *Fix* : Enable the `MULTIBYTE` option, or rather don't disable
it (this option is enabled in Zsh by default). Verify with `print -r -- ${options[MULTIBYTE]}` .
When `MULTIBYTE` is enabled and a UTF-8 locale is available, the first few questions asked by the
configuration wizard assess capabilities of the terminal font. If your answers indicate that some
glyphs don't render correctly, configuration wizard won't offer prompt styles that use them. *Fix* :
Restart your terminal and install
[the recommended font ](#meslo-nerd-font-patched-for-powerlevel10k ). Verify by running
When a UTF-8 locale is available, the first few questions asked by the configuration wizard assess
capabilities of the terminal font. If your answers indicate that some glyphs don't render correctly,
configuration wizard won't offer prompt styles that use them. *Fix* : Restart your terminal and
install [the recommended font ](#meslo-nerd-font-patched-for-powerlevel10k ). Verify by running
`p10k configure` and checking that all glyphs render correctly.
### Cannot install the recommended font
@ -1887,15 +1733,6 @@ There are several ways to fix this.
`POWERLEVEL9K_DIR_ANCHOR_FOREGROUND` and `POWERLEVEL9K_DIR_ANCHOR_BOLD` . You can find them in
`~/.p10k.zsh` .
*Related*: [Incorrect foreground color in VSCode Terminal. ](#incorrect-foreground-color-in-vscode-terminal )
### Incorrect foreground color in VSCode Terminal
By default, VSCode Terminal may arbitrarily replace the foreground color of your choice with a
different color. This behavior can be
[turned off ](https://code.visualstudio.com/docs/terminal/appearance#_minimum-contrast-ratio ) in
VSCode settings.
### Horrific mess when resizing terminal window
When you resize a terminal window horizontally back and forth a few times, you might see this ugly
@ -2092,16 +1929,3 @@ Some fonts have this incorrect dotted icon in bold typeface. There are two ways
```zsh
typeset -g POWERLEVEL9K_OS_ICON_CONTENT_EXPANSION='${P9K_CONTENT}' # not bold
```
### Incorrect git status in prompt
Powerlevel10k uses [gitstatusd ](https://github.com/romkatv/gitstatus ) to inspect the state of git
repositories. The project relies on the [libgit2 ](https://github.com/libgit2/libgit2 ) library, which
has some gaps in its implementation. Under some conditions, this may result in discrepancies between
the real state of a git repository (reflected by `git status` ) and what gets shown in the
Powerlevel10k prompt.
Most notably, [libgit2 does not support `skipHash` ](https://github.com/libgit2/libgit2/issues/6531 ).
If you see incorrect git status in prompt, run `git config -l` and check whether `skipHash` is
enabled. If it is, consider disabling it. Keep in mind that `skipHash` may be implicitly enabled
when activating certain git features, such as `manyFiles` .