https://github.com/nucs/fontregister
FontRegister is a small windows commandline tool to manage fonts installation.
https://github.com/nucs/fontregister
fon font font-awesome font-registry fonts otf ttc ttf
Last synced: 10 months ago
JSON representation
FontRegister is a small windows commandline tool to manage fonts installation.
- Host: GitHub
- URL: https://github.com/nucs/fontregister
- Owner: Nucs
- License: mit
- Created: 2017-10-12T10:02:52.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-01-25T17:22:45.000Z (over 1 year ago)
- Last Synced: 2025-07-26T08:07:08.680Z (11 months ago)
- Topics: fon, font, font-awesome, font-registry, fonts, otf, ttc, ttf
- Language: C#
- Homepage:
- Size: 6.03 MB
- Stars: 31
- Watchers: 2
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
FontRegister
[](https://www.nuget.org/packages/FontRegister/)
[](https://github.com/Nucs/FontRegister)
[](https://github.com/Nucs/FontRegister/blob/master/LICENSE)
FontRegister is both a command-line tool and a csharp native library (pure code) for installing and uninstalling fonts on Windows.
## Key Features
- Ability to install/uninstall fonts in bulk.
- Notify Windows OS about new fonts refreshing the font-lists on other apps immediately (photoshop, word and so on).
- Written in pure C# and Pinvoke with a simple code-first API.
## Supported Font Types
The following font file extensions are supported:
```csharp
".ttf" // TrueType Font
".otf" // OpenType Font
".fon" // Windows Font
".ttc" // TrueType Collection
".fnt" // Windows Font
```
## Commandline
Here's the output of the help command:
```sh
Usage: FontManager [options] [paths...]
Commands:
install [path2] [path3] ... : Install fonts from specified files or directories
uninstall [fontName2] [fontName3] ... : Uninstall specified fonts
Options:
--user, -u : Install for current user only (default)
--machine, -m : Install for all users (requires admin rights)
--all-users : Same as --machine
--update : Forces update/reinstallation of fonts
--force : Same as --update
--notify : Will notify windows applications to reload fonts (always happens on install/uninstall)
--clear-cache, --restart-font-cache
: Restart the Windows Font Cache service after operation
refreshing font list and removing cached uninstalled fonts.
This command physically deletes %LOCALAPPDATA%\**\FontCache directories
Note: All font operations require administrator rights
```
## Usage
```sh
# Note: All font operations require administrator rights
# INSTALLATION EXAMPLES:
# 1. Basic Installation (for current user)
# Installs fonts by copying them to Windows Fonts directory
fontregister install "c:/folder" "c:/font.ttf" "./relativedir/font.otf"
# Note: Folders are searched recursively for font files
# 2. Specify Installation Scope
# For current user (default)
fontregister install "c:/folder" "c:/font.ttf"
fontregister install --user "c:/folder" "c:/font.ttf"
fontregister install -u "c:/folder" "c:/font.ttf"
# For all users / machine-wide
fontregister install --machine "c:/folder" "c:/font.ttf"
fontregister install -m "c:/folder" "c:/font.ttf"
fontregister install --all-users "c:/folder" "c:/font.ttf"
# Update existing fonts from given file/path
fontregister install --update "c:/folder" "c:/font.ttf"
fontregister install --force "c:/folder" "c:/font.ttf"
# UNINSTALLATION EXAMPLES:
# 1. Basic Uninstallation
fontregister uninstall "fontname1" "fontname2"
# 2. Uninstall by Different Name Formats
# By font name as shown in Windows
fontregister uninstall "Calibri (TrueType)" "Calibri Light"
# By filename
fontregister uninstall "calibril.ttf"
# By full path
fontregister uninstall "C:/Windows/Fonts/calibril.ttf"
# By your installation path
fontregister uninstall "C:/folder/calibril.ttf"
# 3. Uninstall with Scope
fontregister uninstall -m "fontname" # Machine-wide
fontregister uninstall -u "fontname" # User scope
# UTILITIES EXAMPLES:
fontregister # Display help
fontregister --clear-cache # Clear font cache
fontregister --notify # notify Windows applications to refresh font list (always done after install/uninstall)
```
## FontRegister Library Code Example
```sh
PM> Install-Package FontRegister
```
```csharp
using FontRegister;
using FontRegister.Abstraction;
// Note: All font operations require administrator rights
// Create system notifier to refresh font lists in other apps
var notifier = new WindowsSystemNotifier();
// Example 1: Install single font for current user
var userInstaller = new WindowsFontInstaller(notifier, InstallationScope.User);
var userFontManager = new FontManager(userInstaller);
userFontManager.InstallFonts(["C:/myfonts/myfont.ttf"]);
// Example 2: Install multiple fonts machine-wide
var machineInstaller = new WindowsFontInstaller(notifier, InstallationScope.Machine);
var machineFontManager = new FontManager(machineInstaller);
machineFontManager.InstallFonts([
"C:/myfonts", // Directory containing fonts
"C:/myfonts2/myfont.ttf" // Single font file
]);
// Example 3: Uninstall fonts
machineFontManager.UninstallFonts([
"MyFontName", // By font name
"myfont.ttf", // By filename
"C:/myfonts/myfont.ttf" // By full path
]);
```
## Contributing
Contributions are welcome! Please open an issue or submit a pull request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgements
- All contributors and users for their support.