# Recommended font: Meslo Nerd Font patched for Powerlevel10k Gorgeous monospace font designed by Jim Lyles for Bitstream, customized by the same for Apple, further customized by AndrΓ© Berg, and finally patched by yours truly with customized scripts originally developed by Ryan L McIntyre of Nerd Fonts. Contains all glyphs and symbols that Powerlevel10k may need. Battle-tested in dozens of different terminals on all major operating systems. *FAQ*: [How was the recommended font created?](README.md#how-was-the-recommended-font-created) ## Automatic font installation If you are using iTerm2 or Termux, `p10k configure` can install the recommended font for you. Simply answer `Yes` when asked whether to install *Meslo Nerd Font*. If you are using a different terminal, proceed with manual font installation. π ## Manual font installation 1. Download these four ttf files: - [MesloLGS NF Regular.ttf]( https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf) - [MesloLGS NF Bold.ttf]( https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf) - [MesloLGS NF Italic.ttf]( https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf) - [MesloLGS NF Bold Italic.ttf]( https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf) 1. Double-click on each file and click "Install". This will make `MesloLGS NF` font available to all applications on your system. 1. Configure your terminal to use this font: - **iTerm2**: Type `p10k configure` and answer `Yes` when asked whether to install *Meslo Nerd Font*. Alternatively, open *iTerm2 β Preferences β Profiles β Text* and set *Font* to `MesloLGS NF`. - **Apple Terminal**: Open *Terminal β Preferences β Profiles β Text*, click *Change* under *Font* and select `MesloLGS NF` family. - **Hyper**: Open *Hyper β Edit β Preferences* and change the value of `fontFamily` under `module.exports.config` to `MesloLGS NF`. - **Visual Studio Code**: Open *File β Preferences β Settings* (PC) or *Code β Preferences β Settings* (Mac), enter `terminal.integrated.fontFamily` in the search box at the top of *Settings* tab and set the value below to `MesloLGS NF`. Consult [this screenshot]( https://raw.githubusercontent.com/romkatv/powerlevel10k-media/389133fb8c9a2347929a23702ce3039aacc46c3d/visual-studio-code-font-settings.jpg) to see how it should look like or see [this issue]( https://github.com/romkatv/powerlevel10k/issues/671) for extra information. - **GNOME Terminal** (the default Ubuntu terminal): Open *Terminal β Preferences* and click on the selected profile under *Profiles*. Check *Custom font* under *Text Appearance* and select `MesloLGS NF Regular`. - **Konsole**: Open *Settings β Edit Current Profile β Appearance*, click *Select Font* and select `MesloLGS NF Regular`. - **Tilix**: Open *Tilix β Preferences* and click on the selected profile under *Profiles*. Check *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.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`. - **Termux**: Type `p10k configure` and answer `Yes` when asked whether to install *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. - **Terminus**: 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*. - **Guake**: Right Click on an open terminal and open *Preferences*. Under *Appearance* 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`. - **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 β Look and Feel* and change *Font:* under *Terminal UI* to `MesloLGS NF Regular`. - **WSLtty**: Right click on an open terminal and then on *Options*. In the *Text* section, under *Font*, click *"Select..."* and set Font to `MesloLGS NF Regular`. - **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.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 font_family MesloLGS NF ``` Restart kitty by closing all sessions and opening a new session. - **puTTY**: Set *Window* β *Appearance* β *Font* to `MesloLGS NF`. Requires puTTY version >= 0.75. - **WezTerm**: Create or open `$HOME/.config/wezterm/wezterm.lua` and add the following: ```lua local wezterm = require 'wezterm'; return { font = wezterm.font("MesloLGS NF"), } ``` If the file already exists, only add the line with the font to the existing return. Also add the first line if it is not already present. - **urxvt**: Create or open `~/.Xresources` and add the following line to it: ```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. 1. Run `p10k configure` to generate a new `~/.p10k.zsh`. The old config may work incorrectly with the new font. _Using a different terminal and know how to set the font for it? Share your knowledge by sending a PR to expand the list!_