Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/romkatv/powerlevel10k/llms.txt

Use this file to discover all available pages before exploring further.

Powerlevel10k works with any monospace font, but to unlock the full range of prompt styles — including powerline separators, Nerd Font icons, and all layout options offered by the configuration wizard — you need a font that contains the required glyphs. Without a compatible font, some prompt styles will not be available and certain characters may render as question marks or empty boxes. The recommended font is MesloLGS NF: a gorgeous monospace font designed by Jim Lyles for Bitstream, customized by the same for Apple, further customized by André Berg, and finally patched with glyph scripts originally developed by Ryan L McIntyre of Nerd Fonts. It contains every glyph and symbol that Powerlevel10k may need and has been battle-tested across dozens of terminals on all major operating systems.
If you are using iTerm2 or Termux, the p10k configure wizard can install MesloLGS NF automatically — simply answer Yes when asked whether to install Meslo Nerd Font. All other terminals require manual installation.

​
Automatic Installation (iTerm2 and Termux)

Run the configuration wizard and answer Yes when prompted: 
p10k configure
The wizard detects iTerm2 and Termux and offers to download and install the font for you. Once installed it also reconfigures the terminal profile automatically. No further steps are required.

​
Manual Installation

For all other terminals, download the four font files and install them on your system before configuring your terminal.
1

Download the four TTF files

Click each link to download, or use curl/wget:
2

Install the fonts on your system

Double-click each .ttf file and click Install. This makes MesloLGS NF available to all applications on your system.On Linux you can alternatively copy the files to ~/.local/share/fonts/ and run fc-cache -fv.
3

Configure your terminal to use MesloLGS NF

Follow the instructions for your terminal in the section below.
4

Regenerate your Powerlevel10k config

p10k configure
The old ~/.p10k.zsh config may not display correctly with the new font. Running the wizard generates a fresh configuration.

​
Terminal Configuration

Find your terminal below and follow the steps to set MesloLGS NF as the active font.
Option A (recommended): Run p10k configure and answer Yes when asked whether to install Meslo Nerd Font. The wizard sets the font automatically.Option B (manual): Open iTerm2 → Preferences → Profiles → Text and set Font to MesloLGS NF.
Open Terminal → Preferences → Profiles → Text, click Change under Font, and select the MesloLGS NF family.
Open Hyper → Edit → Preferences and change the value of fontFamily under module.exports.config to MesloLGS NF.
Open File → Preferences → Settings (Windows/Linux) or Code → Preferences → Settings (macOS). Enter terminal.integrated.fontFamily in the search box and set the value to MesloLGS NF.You can refer to this screenshot to see how the setting should look, or see this issue for additional information.
Software installed via Snap cannot use system fonts. If you installed VS Code via Snap, remove it with sudo snap remove code and install the official .deb build from the VS Code website.
Open Terminal → Preferences and click on the selected profile under Profiles. Check Custom font under Text Appearance and select MesloLGS NF Regular.
Open Settings → Edit Current Profile → Appearance, click Select Font, and select MesloLGS NF Regular.
Open Tilix → Preferences and click on the selected profile under Profiles. Check Custom font under Text Appearance and select MesloLGS NF Regular.
Click the icon in the top-left corner of the console window, then go to Properties → Font and set Font to MesloLGS NF.
Open Settings (Ctrl+,), click either on the selected profile under Profiles or on Defaults, click Appearance, and set Font face to MesloLGS NF.
Open Setup → General → Fonts and set Main console font to MesloLGS NF.
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.
Run p10k configure and answer Yes when asked whether to install Meslo Nerd Font. Termux handles the download and installation automatically.
Open Settings → Appearance and set Font to MesloLGS NF.
Open Preferences using the context menu. Under Profiles select the General tab (selected by default), uncheck Use the system fixed width font (if not already unchecked), and select MesloLGS NF Regular. Click Close to exit.
Right-click on an open terminal and open Preferences. Under the Appearance tab, uncheck Use the system fixed width font (if not already unchecked) and select MesloLGS NF Regular. Click Close to exit.
Open Settings → Configuration → Terminal and, under Terminal look and feel, change Font to MesloLGS NF.If you have saved sessions, you must also update the font for each one: go to Settings → right-click the session → Edit Session → Terminal Settings → Font settings.
Open Preferences → Local Shell Options → Look and Feel, enable Use these personal options, and change Font under Terminal UI to MesloLGS NF Regular.To update the font for remote host connections, go to Preferences → Terminal Options → Look and Feel and change Font under Terminal UI to MesloLGS NF Regular.
Open Warp and navigate to Settings → Appearance. Scroll down to the Text section and, under Terminal Font, select MesloLGS NF.
Right-click on an open terminal and click Options. In the Text section under Font, click Select… and set the font to MesloLGS NF Regular.
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.
Create or open ~/.config/alacritty/alacritty.toml and add the following section:
[font.normal]
family = "MesloLGS NF"
Create or open ~/.config/foot/foot.ini and add the following line:
font=MesloLGS NF:size=12
Create or open ~/.config/kitty/kitty.conf and add the following line:
font_family MesloLGS NF
Restart kitty by closing all sessions and opening a new session.
Go to Window → Appearance → Font and set it to MesloLGS NF.
PuTTY version 0.75 or newer is required.
Create or open $HOME/.config/wezterm/wezterm.lua and add the following:
local wezterm = require 'wezterm';
return {
    font = wezterm.font("MesloLGS NF"),
}
If the file already exists, add only the font line to the existing return table, and add the require line at the top if it is not already present.
Create or open ~/.Xresources and add the following line:
URxvt.font: xft:MesloLGS NF:size=11
You can adjust the font size to your preference. After saving, reload the config:
xrdb ~/.Xresources
The new configuration applies to all new terminal windows.
Create or open ~/.Xresources and add the following line:
xterm*faceName: MesloLGS NF
After saving, reload the config:
xrdb ~/.Xresources
The new configuration applies to all new terminal windows.
Open ~/.config/zed/settings.json and set terminal.font_family to "MesloLGS NF":
{
  "terminal": {
    "font_family": "MesloLGS NF"
  },
  // Other settings.
}
Open chrome-untrusted://terminal/html/nassh_preferences_editor.html, set Text font family to 'MesloLGS NF' (including the single quotes), and set Custom CSS (inline text) to the following:
@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;
}
If you open the standard terminal preferences dialog, these settings will be overwritten and you will need to re-enter them.
Create or open ~/.config/deepin/deepin-terminal/config.conf and add the following section:
[basic.interface.font]
value = "MesloLGS NF"
Open Menu → Open Configuration (Linux) or Ghostty → Settings… (macOS) and add the following line:
font-family = "MesloLGS NF"
Using a terminal not listed here and know how to configure the font? Contributions are welcome — open a pull request on the Powerlevel10k repository to expand the list.

Build docs developers (and LLMs) love

Get started for freeTalk to us