Install Instructions - Powerlevel9k/powerlevel9k GitHub Wiki
There are two steps to start using this theme:
To get the most out of Powerlevel9k, you need to install both the theme as well
as Powerline-patched fonts, if you don't have them installed already. If you
cannot install Powerline-patched fonts for some reason, follow the instructions
below for a compatible install.
No configuration is necessary post-installation if you like the default settings, but there is plenty of segment configuration available if you are interested.
Step 1: Install Powerlevel9k
There are several ways to install and use the Powerlevel9k theme: vanilla ZSH, Oh-My-Zsh, Prezto, Antigen, Zgen, Antibody, ZPM and ZIM. Some Distributions like Arch Linux also provides a package. Do one of the following, depending on how you use ZSH.
Arch Linux
sudo pacman -S zsh-theme-powerlevel9k
To enable Powerlevel9k theme for your user type:
echo 'source /usr/share/zsh-theme-powerlevel9k/powerlevel9k.zsh-theme' >> ~/.zshrc
NixOS
Add this line to your configuration.nix
programs.zsh.promptInit = "source ${pkgs.zsh-powerlevel9k}/share/zsh-powerlevel9k/powerlevel9k.zsh-theme";
macOS with homebrew
First get the homebrew tap
brew tap sambadevi/powerlevel9k
Then install powerlevel9k via brew
brew install powerlevel9k
To load powerlevel9k in your zsh simply add the following line to your .zshrc:
source /usr/local/opt/powerlevel9k/powerlevel9k.zsh-theme
Alternatively you can run this command to append the line to your .zshrc
echo "source /usr/local/opt/powerlevel9k/powerlevel9k.zsh-theme" >> ~/.zshrc
As an alternative you can also install a specific version (0.6.3 as an example)
brew install [email protected]
Further steps, how to integrate p9k into your .zshrc, will be shown after installation:
$ brew install [email protected]
...
If you want to load powerlevel9k in your zsh simply add the following line to your .zshrc:
source /usr/local/opt/[email protected]/powerlevel9k.zsh-theme
Alternatively you can run this command to append the line to your .zshrc
echo "source /usr/local/opt/[email protected]/powerlevel9k.zsh-theme" >> ~/.zshrc
Option 1: Install for Vanilla ZSH
If you just use a vanilla ZSH install, simply clone this repository and
reference it in your ~/.zshrc:
$ git clone https://github.com/bhilburn/powerlevel9k.git ~/powerlevel9k
$ echo 'source ~/powerlevel9k/powerlevel9k.zsh-theme' >> ~/.zshrc
Option 2: Install for Oh-My-ZSH
To install this theme for use in
Oh-My-Zsh, clone this repository
into your OMZ custom/themes directory.
$ git clone https://github.com/bhilburn/powerlevel9k.git ~/.oh-my-zsh/custom/themes/powerlevel9k
You then need to select this theme in your ~/.zshrc:
ZSH_THEME="powerlevel9k/powerlevel9k"
Please note if you plan to set a POWERLEVEL9K_MODE to use a specific font, as described in this section of the Wiki, you must set the MODE before OMZ is loaded (look for source $ZSH/oh-my-zsh.sh in your ~/.zshrc).
Option 3: Install for Prezto
To install this theme for use in Prezto, clone this repository into your
Prezto prompt/external directory.
$ git clone https://github.com/bhilburn/powerlevel9k.git ~/.zprezto/modules/prompt/external/powerlevel9k
$ ln -s ~/.zprezto/modules/prompt/external/powerlevel9k/powerlevel9k.zsh-theme ~/.zprezto/modules/prompt/functions/prompt_powerlevel9k_setup
You then need to select this theme in your ~/.zpreztorc:
zstyle ':prezto:module:prompt' theme 'powerlevel9k'
Please note if you plan to set a POWERLEVEL9K_MODE to use a specific font, as described in this section of the Wiki, you must set the MODE before prezto is loaded.
Option 4: Install for antigen
To install this theme for use in antigen, just add this at the beginning
of your ~/.zshrc:
POWERLEVEL9K_INSTALLATION_PATH=$ANTIGEN_BUNDLES/bhilburn/powerlevel9k
And this anywhere after:
antigen theme bhilburn/powerlevel9k powerlevel9k
antigen apply
Note that you should define any customizations at the top of your .zshrc (i.e. setting the POWERLEVEL9K_* variables) in your .zshrc.
You may need to do a rm -rf ~/.antigen to force a reinstall of all the antigen bundles. Also, remember to restart your terminal emulator after this step.
Option 5: Install for Zplug
To install this theme for use in Zplug, just add this
in your ~/.zshrc:
zplug "bhilburn/powerlevel9k", use:powerlevel9k.zsh-theme
Note that you should define any customizations at the top of your .zshrc
(i.e. setting the POWERLEVEL9K_* variables) in your .zshrc.
Option 6: Install for Zgen
To install this theme for use in zgen, just add this
in your ~/.zshrc:
zgen load bhilburn/powerlevel9k powerlevel9k
Note that you should define any customizations at the top of your .zshrc
(i.e. setting the POWERLEVEL9K_* variables) in your .zshrc.
Option 7: Install for Antibody
To install this theme for use in Antibody, just add this
in your ~/.zshrc:
antibody bundle bhilburn/powerlevel9k
Note that you should define any customizations at the top of your .zshrc
(i.e. setting the POWERLEVEL9K_* variables) in your .zshrc.
Option 8: Install for zpm
To install this theme for use in zpm, just add this
in your ~/.zshrc:
zpm load bhilburn/powerlevel9k
Note that you should define any customizations at the top of your .zshrc
(i.e. setting the POWERLEVEL9K_* variables) in your .zshrc.
Option 9: Install for Zim
Add zmodule bhilburn/powerlevel9k to your .zimrc and run zimfw install.
Note that you should define any customizations at the top of your .zshrc
(i.e. setting the POWERLEVEL9K_* variables) in your .zshrc.
Step 2: Install a Powerline Font
In order for the theme to render properly, you need a font that has the "Powerline" glyphs. These are used at the start & end of the segments to produce the "powerline" appearance. Additionally, if your font includes any of the expanded glyph set, Powerlevel9k is capable of making use of those to produce a very nice prompt.
Dealing with fonts can be really confusing, and you have multiple options for installing fonts. You can find more details about how fonts, and the various forms of installation described below, work on the 'About Fonts' page of the Wiki.
N.B.: If Powerlevel9k is not working properly, it is almost always the case that the fonts were not properly installed, or you have not configured your terminal to use a Powerline-patched font - (you must change it)!
There are four ways you can get a Powerline font:
Option 1: Install Powerline Fonts
You can find the installation instructions for Powerline Fonts here. You can also find the raw font files in this Github repository if you want to manually install them for your OS.
After you have installed Powerline fonts, make the default font in your terminal emulator the Powerline font you want to use.
This is the default mode for Powerlevel9k, and no further configuration is
necessary.
Option 2: Use a Programmer Font
There are now some fonts, meant specifically for software programmers, that not only provide the necessary powerline glyphs but may also have some of the additional glyphs from Font Awesome. The most well-known are Adobe Source Code Pro and Source Code Pro, which are usually available from your OS's package manager.
NOTE: The default "programmer" fonts have some of the glyphs, like the segment separators, but are missing many others. If you plan to use anything more than the basic glyphs, you'll need a patched version of those fonts, like those you would find in Options 3 and 4, below.
Once you have installed the font, configure your terminal to use that font. Powerlevel9k should then work immediately, with no additional configuration.
These fonts usually also have some of the icons from the 'Awesome Font' special character set. If you wish to take advantage of the additional glyphs, put the following in your ~/.zshrc before you specify the powerlevel9k theme:
POWERLEVEL9K_MODE='awesome-fontconfig'
Option 3: Install Awesome-Powerline Fonts
Alternatively, you can install Awesome-Terminal Fonts, which provide a number of additional glyphs.
You then need to indicate that you wish to use the additional glyphs by defining
one of the following in your ~/.zshrc before you specify the powerlevel9k theme:
If you use fontconfig to install them:
POWERLEVEL9K_MODE='awesome-fontconfig'
If you use pre-patched fonts:
POWERLEVEL9K_MODE='awesome-patched'
Option 4: Install Nerd-Fonts
The Nerd-Fonts project is an effort to create fonts truly tricked out with as many glyphs as possible. After installing nerd-fonts and configuring your terminal emulator to use one, configure Powerlevel9k by putting the following in your ~/.zshrc before you specify the powerlevel9k theme:
POWERLEVEL9K_MODE='nerdfont-complete'