174 lines
9.4 KiB
Markdown
174 lines
9.4 KiB
Markdown
# 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* (<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`.
|
|
- **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.
|
|
- **Tabby** (formerly **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`. 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*.
|
|
- **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.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
|
|
```
|
|
- **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.
|
|
- **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.
|
|
- **Deepin Terminal**: Create or open `~/.config/deepin/deepin-terminal/config.conf` and add the following section
|
|
to it:
|
|
```ini
|
|
[basic.interface.font]
|
|
value = "MesloLGS NF"
|
|
```
|
|
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!_
|