oh-my-posh/website/docs/configuration/fonts.md

55 lines
1.6 KiB
Markdown
Raw Normal View History

2021-03-12 16:19:26 -08:00
---
2022-04-20 09:43:59 -07:00
id: fonts
2021-03-12 16:19:26 -08:00
title: Fonts
2021-11-12 10:14:16 -08:00
sidebar_label: Fonts
2021-03-12 16:19:26 -08:00
---
### Nerd Fonts
Oh My Posh was designed to use [Nerd Fonts][nerdfonts]. Nerd Fonts are popular fonts that are patched to include icons.
2021-03-12 16:19:26 -08:00
We recommend [Meslo LGM NF][meslo], but any Nerd Font should be compatible with the standard [themes][themes].
To see the icons displayed in Oh My Posh, **install** a [Nerd Font][nerdfonts], and **configure** your terminal to use it.
2021-03-12 16:19:26 -08:00
#### Installation
2021-03-12 16:19:26 -08:00
Oh My Posh has a CLI to help you select and install a [Nerd Font][nerdfonts] (beta):
```bash
oh-my-posh font install
```
2021-03-12 16:19:26 -08:00
#### Windows Terminal
Once you have installed a Nerd Font, you will need to configure the Windows Terminal to use it. This can be easily done
by modifying the Windows Terminal settings (default shortcut: `CTRL + SHIFT + ,`). In your `settings.json` file, add the
2022-04-26 10:50:38 -07:00
`font.face` attribute under the `defaults` attribute in `profiles`:
2021-03-12 16:19:26 -08:00
```json
{
"profiles":
{
"defaults":
{
"font":
{
"face": "MesloLGM NF"
}
2021-03-12 16:19:26 -08:00
}
}
}
```
### Other Fonts
If you are not interested in using a Nerd Font, you will want to use a theme which doesn't include any Nerd Font icons.
The `minimal` themes do not make use of Nerd Font icons.
[Creating your own theme][configuration] is always an option too 😊
[nerdfonts]: https://www.nerdfonts.com/
[meslo]: https://github.com/ryanoasis/nerd-fonts/releases/download/v2.1.0/Meslo.zip
[themes]: https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/themes
[font-thread]: https://github.com/JanDeDobbeleer/oh-my-posh/issues/145#issuecomment-730162622
2022-04-20 09:43:59 -07:00
[configuration]: /docs/configuration/overview