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
|
2022-06-03 07:47:56 -07:00
|
|
|
sidebar_label: 🔤 Fonts
|
2021-03-12 16:19:26 -08:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### Nerd Fonts
|
|
|
|
|
|
2021-06-05 10:27:33 -07:00
|
|
|
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].
|
|
|
|
|
|
2021-06-05 10:27:33 -07:00
|
|
|
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
|
|
|
|
2022-06-02 02:30:41 -07:00
|
|
|
#### Installation
|
2021-03-12 16:19:26 -08:00
|
|
|
|
2022-06-02 02:30:41 -07:00
|
|
|
Oh My Posh has a CLI to help you select and install a [Nerd Font][nerdfonts] (beta):
|
|
|
|
|
|
2022-08-09 23:42:18 -07:00
|
|
|
:::caution Windows
|
2022-06-03 07:47:56 -07:00
|
|
|
This command needs to be executed as admin. The fonts are installed system wide.
|
|
|
|
|
:::
|
|
|
|
|
|
2022-06-02 02:30:41 -07:00
|
|
|
```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
|
2021-07-03 01:57:44 -07:00
|
|
|
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":
|
|
|
|
|
{
|
2021-12-19 02:20:27 -08:00
|
|
|
"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
|
