As a programmer, the terminal is pretty much your daily weapon. You use it to run programs, start the Python interpreter, manage servers, or just to cosplay "happy hacking" for fun. ๐
But the default terminal look, an empty black box with white text and a blinking cursor, often feels stiff and intimidating. That goes double if you're touching programming for the first time.
No wonder it pushes people away from the terminal, programmers included. Once you know the trick, though, the terminal lets you do plenty of things far faster and more practically.
Imagine a way to make the terminal feel friendlier (friendly), with colorful decoration on the left and right sides. Typing in the terminal would feel a lot more fun and enjoyable.
Well, good news! ๐ With Starship, you can transform a command line that was plain white text on pitch black.
๐ท Illustration: the default Windows PowerShell window with a standard white text prompt.
That prompt turns into something alive, with informative color, directory status icons, and a sharp Git branch indicator.
๐ท Illustration: the PowerShell window after the Starship prompt is installed, with color accents and interactive directory icons.
See how much better that looks? ๐ฎ
Key takeaways
- Starship is a cross-platform prompt written in Rust, and it is fast, safe, and easy to customize.
- To show special icons and symbols in Starship, you have to install and enable a Nerd Font first.
- Installing Starship on Windows is flexible, through winget, Scoop, Chocolatey, or a manual installer.
- Ready-made presets like Pastel Powerline let you theme the terminal without writing a config from scratch.
A Quick Intro to Starship
Before we get into installation, let's get acquainted with Starship first.
For some people, the name "starship" brings to mind a fictional spacecraft exploring distant galaxies.
Relax, though, we're not here for space conspiracy theories, haha. Let's get back to the main focus.
So Starship is actually a cross-platform prompt you can customize however you like. With Starship, you can turn a flat black-and-white command line into something full of informative color.
Technically, Starship is built with the Rust programming language. That makes it very fast, light, and safe on any system.
Because it's cross-platform, it installs on any operating system. Linux, macOS, Windows, even Android through Termux.
Linux and macOS users already have plenty of popular shells they can tinker with, like Zsh or Fish. So this time we'll focus on installing it on Windows only. More specifically, we'll set it up in Windows PowerShell.
Installing Starship in Windows PowerShell
For Starship to display perfectly with no broken characters, you need three main components:
- Nerd Font โ A special font that supports a wide range of unique icons and decorative characters.
- Starship โ The main prompt program we're going to install.
- Preset โ A ready-made theme configuration, so you don't have to design one from scratch.
Without further delay, let's run through the steps below!
1. Download and Install Nerd Font
Installing Nerd Font works the same way as any standard font installation.
First, visit the Nerd Font download page and pick a font you like. In this guide, I'll use my favorite, FiraCode Nerd Font.
Once the .zip file finishes downloading, extract it and open the folder. Inside you'll find a lot of files in .ttf and .otf format.
Next, select all those .ttf and .otf font files, right-click, and choose Install (or Install for all users). Windows will install every weight variant into the system font directory automatically.
๐ท Illustration: the right-click menu in Windows Explorer while selecting the FiraCode Nerd Font file set for installation.
2. Enable Nerd Font in Windows Terminal
Once the font is installed on Windows, it won't activate in your terminal by itself. You have to configure it first.
Note: This tutorial uses the Windows Terminal app. If you use a different terminal app, adjust the settings in its own configuration menu.
Open Windows Terminal and press Ctrl + , to bring up the Settings page.
In the left navigation menu, click PowerShell, then open Appearance. Under Font face, switch it to FiraCode Nerd Font or whichever font you installed earlier.
Don't forget to click Save to keep the change.
3. Install the Starship Prompt
Now let's install Starship. You can do it straight from the command line in your terminal.
On Windows 11, or on the latest Windows 10 builds with a built-in package manager, run this command:
winget install --id Starship.Starship
Wait a few minutes for the download and automatic installation to finish successfully.
If that command fails because winget isn't configured, an alternative package manager like Chocolatey or Scoop works too.
With Chocolatey:
choco install starship
With Scoop:
scoop install starship
What if none of those work? Don't worry, you can still download the installer manually from the official Starship releases page. Find the latest .msi installer, download it, then run the installation like any other app.
4. Configure the PowerShell Profile
Even with Starship installed successfully, your terminal may still look ordinary. That's expected, since we haven't told PowerShell to load the Starship module on startup.
To fix it, run this command inside your PowerShell terminal:
if (!(test-path $PROFILE)) {new-item -type file -path $PROFILE -force} `
"Invoke-Expression (&starship init powershell)" >> $PROFILE
After running it, close PowerShell and open it again. If the configuration worked, your prompt will switch to the Starship arrow with the active directory name.
๐ท Illustration: a freshly loaded PowerShell window with the default Starship prompt configuration.
If nothing changes and you run into an error like this instead:
Microsoft.PowerShell_profile.ps1 cannot be loaded because running scripts
is disabled on this system. For more information, see about_Execution_Policies at
https:/go.microsoft.com/fwlink/?LinkID=135170.
That means Windows is blocking PowerShell from running profile script files. To allow script execution, run this command with administrator rights:
Set-ExecutionPolicy -ExecutionPolicy ByPass -Scope CurrentUser
Then exit PowerShell and open it again. Your terminal should now follow the default Starship theme.
5. Install a Preset Theme
At this point your terminal is already ready for battle. If the default look satisfies you, you can skip this fifth step.
If you get bored easily and want a more striking visual style, you can use the preset feature.
Visit the Starship presets page and pick the theme that fits your taste. Then download the .toml configuration file provided there. Here, I'll use the Pastel Powerline theme as an example.
Next, open PowerShell directly in the folder where the downloaded .toml file sits, and run this command:
if (!(test-path $HOME\.config)) {new-item $HOME\.config -type Directory}
Still in the same directory, move that file into the Starship config folder. Make sure you replace nama-preset with the actual file name you downloaded:
move-item -path nama-preset.toml -destination $HOME\.config\starship.toml -force
For example, if you're using the Pastel Powerline theme, the command looks like this:
move-item -path pastel-powerline.toml -destination $HOME\.config\starship.toml -force
The moment the command finishes, your terminal changes into the new design, with layered pastel color segments.
๐ท Illustration: the PowerShell interface with the Pastel Powerline preset theme, showing colorful segments and system icons.
Pretty cool, right? ๐
If you want to change the mood later, download the .toml file for another theme and run the move command above again.
Your terminal is no longer stiff black and white. It's full of color, which makes coding feel more comfortable. For more complete information on deep customization, drop by the official Starship site.
Have fun and happy hacking with your new terminal! ๐