How to make Seelen UI Icon Packs

Directory: %appdata%\com.seelen.seelen-ui\iconpacks

• C:\Users\USER\AppData\Roaming\com.seelen.seelen-ui\iconpacks

To start, create a folder within the directory folder noted at the top. Name it whatever you would like in order to distinguish your pack.

Within this folder, place all your image files. Any common image format is supported (Like: PNG, JPG, SVG, ICO).

Once done, create a .txt file inside and then rename it to metadata.yml, replacing the .txt extension. Or if you can, directly create the .yml file. This file will contain all the required information for your icon pack.

my-icon-pack/
├─ metadata.yml
├─ explorer.png
├─ firefox_light.png
├─ chrome_dark.png
└─ folder.svg

Alright, now open up the metadata.yml in your text or code editor of choice and type in or copy and paste the below contents:

id: '@yourname/icon-pack-example'
metadata:
  displayName: "Example Icon Pack"
  appTargetVersion:
    - 2
    - 4
    - 10
entries:

ID is just your friendly identifier for the pack.

App Target Version does not need to be updated unless there has been a change/update to the icon pack system. However if you want no version warnings, set it to the latest version at the time of creation and update as wanted.

If you have plans to publish icon packs to the site, you can add language translations to the above like so:

id: '@yourname/icon-pack-example'
metadata:
  displayName:
    en: "Example Icon Pack"
    es: "Paquete de Iconos de Ejemplo"
  description:
    en: "An example icon pack."
    es: "Un paquete de iconos."
  appTargetVersion:
    - 2
    - 4
    - 10
entries:

● Language List.

Note that the description is what is shown on your resource's page to explain it's purpose.

Alright, after you've done that, we need to add entries for each app whose icon you want to change. Here's a quick overview first:

- type: ~
  ...
  icon:
    base: ~
    light: ~
    dark: ~
    mask: ~

Available Type's: unique , shared , and custom.

As for the Icon options...

● Base sets the default icon to be used.

● Light sets the icon to be used when you are in Light Mode (Personalization > Colors).

● Dark sets the icon to be used when you are in Dark Mode (Personalization > Colors).

└─ Note that if you have both light and dark icons set alongside base, the base icon will not be used in any situation, so do not include it.

● Mask sets a icon to be overlayed over your other icons as a transparent layer.

└─ Note that if you wish to retain the color of you icons, no discoloring, ensure to set mask to null.

Now open up seelen settings if it's not already (Win + K or right click the toolbar or dock and select the option), and navigate to the For Developers tab near the bottom.

ENABLE Developer Tools. Once you do, you will see a new tab appear under For Developers called Cached Icons.

This tab will make the entry creating process easier for you. It will list all current icons part of the system pack (populated as you open your apps) and will display the PATH, FILENAME, and UMID of said apps. Values you'll need for entry creation.

With that, here are your full entry structures

Type — unique

Direct path:

- type: unique
  path: C:\Windows\explorer.exe
  icon:
    base: explorer.png

Apps with UMID (UWP Apps):

- type: unique
  umid: Microsoft.Windows.Photos_8wekyb3d8bbwe!App
  path: C:\Program Files\WindowsApps\Microsoft.Windows.Photos\Photos.exe
  icon:
    light: photos_light.png
    dark: photos_dark.png

• Note: Enclose paths with spaces in them with quotation marks.

Type — custom

Specific components: Start Menu Icon and Explorer Icon:

- type: custom
  key: '@seelen/weg::start-menu'
  icon:
    base: start-menu-icon.svg
    mask: start-menu-icon.svg

- type: custom
  key: '@seelen/weg::folder'
  icon:
    base: folder-icon.svg
    mask: folder-icon.svg

Type — shared

Used for file extensions like .png, .zip, .mp4, etc.

- type: shared
  extension: png
  icon:
    base: png.png

- type: shared
  extension: zip
  icon:
    base: zip.png

Example Pack

id: '@yourname/icon-pack-example'
metadata:
  displayName: "Example Icon Pack"
  appTargetVersion:
    - 2
    - 4
    - 10
entries:
  - type: unique
    umid: Microsoft.Windows.Photos_8wekyb3d8bbwe!App
    path: C:\Program Files\WindowsApps\Microsoft.Windows.Photos_2025.11040.23001.0_x64__8wekyb3d8bbwe\Photos.exe
    icon:
      light: photo.ico
      dark: photo.ico
      isAproximatelySquare: true
  - type: unique
    path: C:\Windows\System32\cmd.exe
    icon:
      base: terminal.ico
  - type: unique
    path: C:\Windows\System32\Taskmgr.exe
    icon:
      base: activity.ico