Skip to content

A tool to support working with Microsoft symbol font icons in C#/XAML applications

License

Notifications You must be signed in to change notification settings

robloo/SymbolIconManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

User Guide Icon Mapping Details Icon Set Data ReadMe

Symbol Icon Manager

The Symbol Icon Manager is an application written to facilitate working with Microsoft's various symbol icon fonts. Its most widely-useful tool is a font builder that allows mapping glyphs from a source icon set into a destination icon set (by Unicode point). In practice this means it is possible to build a free and open source variant of Microsoft's proprietary fonts (Segoe MDL2 Assets and Segoe Fluent Icons) that can be used as a drop-in replacement for apps that need it cross-platform. Using Microsoft's fonts in cross-platform projects directly is not possible due to licensing.

In other words, the primary purpose of this tool is to build alternatives for Microsoft's symbol icon fonts for both the Avalonia and Uno Platform cross-platform UI frameworks. Usage outside of this purpose is limited and there are only a handful of developers that will need this functionality.

Origin

This application was originally an internal tool written to migrate a C#/UWP codebase from Segoe MDL2 Assets to the cross-platform Fluent UI System Icons. Before a Segoe Fluent Icons cross-platform alternative was available (from this project), the new icons were needed to match the latest Fluent design system. The internal tooling (icon re-mapping) made it much easier to migrate and supported automatic switching between Fluent UI System glyph sizes and variants.

From there it wasn't much of a stretch to add the remainder of the tooling -- including the font builder. The design and architecture of such an application was already conceived. Additionally, symbol icons are something that have historically locked developers to a given platform. Removing this lock helps others writing cross-platform applications using, for example, Avalonia or the Uno Platform. This is in the same spirit as Microsoft's open-source Fluent UI System Icons.

Scope

This project is currently focusing on Microsoft's symbol icon fonts including Segoe MDL2 Assets and Segoe Fluent Icons. Other symbol icon sets (such as Line Awesome) are used only to provide equivalent glyphs for Microsoft's already defined Unicode points. Symbol icons for other frameworks or platforms are currently out of scope.

Pre-Built Fonts

The table below provides information for those looking for pre-built, drop-in replacements for Microsoft's various symbol icon fonts.

Font Name & Link Microsoft Equivalent Mapping File
WinSymbols1.ttf Segoe UI Symbol None (Translates to SegoeMDL2Assets Unicode points and then uses the same, backwards-compatible mapping file from SegoeFluent.)
WinSymbols2.ttf Segoe MDL2 Assets None (Uses the same, backwards-compatible mapping file from SegoeFluent)
WinSymbols3.ttf Segoe Fluent Icons SegoeFluent.json
FluentUISystemFilled.ttf FluentSystemIcons-Filled.ttf None (Identity)
FluentUISystemRegular.ttf FluentSystemIcons-Regular.ttf None (Identity)
  • Note that WinSymbols3 is backwards compatible with WinSymbols2 by Unicode point. However, the glyph design/style will be different.
  • Fluent UI System fonts are included due to missing glyphs with Unicode Point over 0xFFFF in Microsoft provided TrueType Font files. These also serve as good tests for the font build system.

App Functionality

This application has the following functionality:

Icon Sets Viewer Icon Mapping & Font Builder Application Tools

  1. Icon Sets Viewer
    • Quickly browse through all Microsoft symbol font glyphs.
    • Supports search/filtering to find glyphs faster.
  2. Icon Mapping & Font Builder
    • Provides tools to facilitate making and reviewing icon set mapping files (by Unicode point/Glyph).
    • Provides a tool to build cross-platform, open-source variants of Microsoft's Symbol fonts using icon mapping files.
  3. Application Tools
    • Provides a tool to list all symbol icons used in an app's source code (C#/XAML files).
    • Provides a tool to remap icon Unicode points from one symbol icon set to another. This is done by replacing all occurances of one Unicode point with another (usually in a FontIcon's Glyph property). For example, this can be used to switch an application's source code from using Segoe MDL2 Assets to Fluent UI System Icons.
    • [Planned] Provides a tool to build an application-specific custom symbol font containing only the glyphs actually needed by the application's source code (C#/XAML). Fonts are quite large (commonly around 1MB) and some apps may not want to package the whole thing. This tool significantly reduces the font file size.

Ideas for future consideration:

  • Work with XAML path data for icons directly instead of through icon fonts. This can simplify usage (and file size) in some applications and scenarios. Think of this as a feature to convert FontIcons into PathIcons.

Contributing

Anyone can contribute by submitting a PR or opening an issue (especially for missing mappings). There are well over a thousand icons in any given symbol icon set (font) so everyone is encouraged to add the mappings that are important for their applications. Contributions are very welcome!

For more instructions on how to modify icon mapping files see Icon Mapping.

Third-Party Resources

This application is possible thanks to the work of others:

Significant credit goes to Microsoft for open sourcing the symbol icon fonts and glyph sources that make most of this possible. This includes the older WinJS Symbols font as well as the newer Fluent UI System Icons which share a design language with current Segoe Fluent Icons.

Special thanks to the Uno Platform for making a great cross-platform UI framework. Use of the Uno Platform drove the creation of this repository due to the need for a cross-platform symbol font variant matching the new Segoe Fluent Icons style.

About

A tool to support working with Microsoft symbol font icons in C#/XAML applications

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages