From ee958a6209d222bd6ab9b2a3439339d14186c27f Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 4 May 2026 15:07:54 +0200 Subject: [PATCH 1/4] Add usage documentation for checking, updating, and uninstalling NerdFonts --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/README.md b/README.md index 75913ac..a7e3668 100644 --- a/README.md +++ b/README.md @@ -53,6 +53,53 @@ This requires the shell to run in an elevated context (sudo or run as administra Install-NerdFont -All -Scope AllUsers ``` +### Check if a NerdFont is installed + +The [Fonts](https://psmodule.io/Fonts) module is installed automatically as a dependency and provides the +[`Get-Font`](https://psmodule.io/Fonts/Functions/Get-Font/) command for querying installed fonts on the system. + +To check if a specific NerdFont is installed for the current user: + +```powershell +Get-Font -Name 'FiraCode*' +``` + +To check across all users on the system: + +```powershell +Get-Font -Name 'FiraCode*' -Scope AllUsers +``` + +If the command returns results, the font is installed. If it returns nothing, the font is not installed in that scope. + +### Update an installed NerdFont + +Individual font files do not embed a NerdFonts release version, so there is no direct way to check whether an installed +NerdFont is outdated. To ensure you have the latest version, reinstall the font using the `-Force` parameter: + +```powershell +Install-NerdFont -Name 'FiraCode' -Force +``` + +This downloads and installs the font from the latest NerdFonts release, overwriting any existing version. + +### Uninstall a NerdFont + +To uninstall a NerdFont, use the [`Uninstall-Font`](https://psmodule.io/Fonts/Functions/Uninstall-Font/) command +from the [Fonts](https://psmodule.io/Fonts) module (installed automatically as a dependency). + +To uninstall a NerdFont from the current user: + +```powershell +Uninstall-Font -Name 'FiraCode*' # Tab completion works on name +``` + +To uninstall a NerdFont for all users (requires elevated privileges): + +```powershell +Uninstall-Font -Name 'FiraCode*' -Scope AllUsers +``` + ## Contributing Coder or not, you can contribute to the project! We welcome all contributions. From c76bf8a72924dfe95a090084a11d84b722acab3e Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 4 May 2026 16:40:10 +0200 Subject: [PATCH 2/4] Add AllUsers scope example to Update section per review feedback The update/reinstall section only showed the default CurrentUser scope, inconsistent with Check and Uninstall sections that show both scopes. Added -Scope AllUsers variant with elevation note to prevent users from accidentally creating a separate per-user install when updating a system-wide font. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index a7e3668..9e7ae75 100644 --- a/README.md +++ b/README.md @@ -81,6 +81,12 @@ NerdFont is outdated. To ensure you have the latest version, reinstall the font Install-NerdFont -Name 'FiraCode' -Force ``` +If the font was originally installed for all users, update it with the matching scope (requires elevated privileges): + +```powershell +Install-NerdFont -Name 'FiraCode' -Force -Scope AllUsers +``` + This downloads and installs the font from the latest NerdFonts release, overwriting any existing version. ### Uninstall a NerdFont From 4bb0f346dbe1e15bfb3c4833d81f383db149283c Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 4 May 2026 22:32:07 +0200 Subject: [PATCH 3/4] Clarify that -Force installs module-bundled font version, not live upstream; add Update-Module guidance --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9e7ae75..fc04526 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,7 @@ If the command returns results, the font is installed. If it returns nothing, th ### Update an installed NerdFont Individual font files do not embed a NerdFonts release version, so there is no direct way to check whether an installed -NerdFont is outdated. To ensure you have the latest version, reinstall the font using the `-Force` parameter: +NerdFont is outdated. To ensure you have the version bundled with the module, reinstall the font using the `-Force` parameter: ```powershell Install-NerdFont -Name 'FiraCode' -Force @@ -87,7 +87,8 @@ If the font was originally installed for all users, update it with the matching Install-NerdFont -Name 'FiraCode' -Force -Scope AllUsers ``` -This downloads and installs the font from the latest NerdFonts release, overwriting any existing version. +This re-downloads and installs the font version bundled with your installed NerdFonts module, overwriting any existing +files. To pick up newer font releases, update the NerdFonts module first (`Update-Module -Name NerdFonts`). ### Uninstall a NerdFont From 1c60ab308026ca1e1a31878a0eff20d3ed419d12 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 4 May 2026 23:02:52 +0200 Subject: [PATCH 4/4] Add missing code block for installing all NerdFonts --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index fc04526..9cd5030 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,7 @@ Install-NerdFont -Name 'FiraCode' -Scope AllUsers #Tab completion works on Scope To install all NerdFonts on the system you can use the following command. This will download and install all NerdFonts to the current user. + ```powershell Install-NerdFont -All ```