Installation

1. Setup your terminal#

Terminal#

While Oh my Posh works on the standard terminal, we advise using the Windows Terminal.

Font#

To see the icons displayed in Oh my Posh, install and configure your terminal to use a powerline enabled font. The fonts we use are patched by Nerd Fonts, which offer a maximum of icons you can use.

Oh my Posh was designed using Meslo LGM NF, but any Nerd Font should be compatible with the standard themes.

Windows fonts

Make sure to install fonts system wide to avoid seeing rectangles in your terminal. See this thread for more context.

2. Install Oh my Posh#

A Powershell module is available for easy installation.

Installation#

Install-Module oh-my-posh -Scope CurrentUser -AllowPrerelease

Usage#

Show all themes#

To display every available theme in the current directory, use the following cmdlet.

Get-PoshThemes

3. Replace your existing prompt#

info

If you have no idea which shell you're currently using, Oh my Posh has a utility switch that can you tell you (not relevant for the Powershell module).

oh-my-posh --print-shell

Edit $PROFILE in your preferred PowerShell version and add the following line.

Invoke-Expression (oh-my-posh --init --shell pwsh --config "$(scoop prefix oh-my-posh)/themes/jandedobbeleer.omp.json")

Once added, reload your profile for the changes to take effect.

. $profile

5. Next steps#

At this point you're good to go. The jandedobbeleer.omp.json theme displays most common use-cases in your prompt so 9/10 you'll be more than happy with it. However, if you want to explore additional functionality, going through the additional steps below will help you get started.

Change the theme#

We downloaded all the themes and set jandedobbeleer.omp.json as the one to use. However, there are a lot more to be discovered and maybe there are some you like better.

Adjust your configuration to use any other theme from the folder we created (~/.poshthemes).

Override the theme settings#

Maybe there's a theme you like, but you don't fancy the colors. Or, maybe there's a segment you want to tweak/add, or replace some of the icons with a different one. Whatever the case, read through all available options first, by starting with the configuration guide.

You can output the current theme to its JSON representation which can be used to tweak and store as your custom theme.

Export-PoshTheme -FilePath ~/.mytheme.omp.json

Once you're done editing, adjust your $PROFILE to use your newly created theme.

Set-PoshPrompt -Theme ~/.mytheme.omp.json

๐ŸŽ‰๐ŸŽ‰๐ŸŽ‰