WezTerm - Windows Builds with Alternative Icons

Quick Windows install via Scoop bucket

add the new custom scoop bucket

scoop bucket add wezterm-alt-icon https://github.com/ocodo/wezterm-alt-windows-icon-builds.git
scoop search wezterm # list all the icons

Then install a build of wezterm latest with icon

# e.g. install mikker-black icon
scoop install wezterm-alt-icon/wezterm-mikker-black

Carry on reading for full info or go check out the wezterm docs

Full info:

This repository automatically syncs with wezterm/wezterm to fetch the latest Windows zip distribution and creates custom builds with alternative icons.

For each custom icon listed below, we:

1. Create a patched version of wezterm-gui.exe with the icon
2. Package it as a separate Windows zip file

Want to contribute an icon?

If you'd like to add an icon, open a new icon issue and assuming it passes quality controls/community interest (votes, socials, or I personally flip at how gorgeous it it!), it'll be integrated & added to the build/distribution process.

Make it a banger 👍

About These Icons

See original discussion: wezterm/wezterm#2396

Special thanks to all icon creators for their contributions. If you're an icon creator and would like your work removed for any reason, please contact @jasonm23 in the above thread.

Available Alternate Icons

	Darkbrite-Deux @gf3		Darkbrite-Une @gf3
	Darksoft-Deux @gf3		Darksoft-Une @gf3
	Darkultra-Nueng @gf3		Darkultra-Sam @gf3
	Darkultra-Song @gf3		Shine @gf3
	Ultrabrite @gf3		Base @grapao
	Forest @grapao		Green @grapao
	Original-Style @grapao		Pastel @grapao
	Black @mikker

Installation with Scoop

Important

Scoop provides an easy way to install and manage WezTerm icon variants on Windows. Make sure you have scoop installed first.

Quick Start

First installation:

scoop bucket add wezterm-alt-icon https://github.com/ocodo/wezterm-alt-windows-icon-builds.git
scoop install wezterm-alt-icon/wezterm-mikker-black

To switch to a different icon, uninstall the current version and install the desired variant. Your WezTerm configuration files will be preserved during the switch.

scoop uninstall wezterm-alt-icon/wezterm-mikker-black
scoop install wezterm-alt-icon/wezterm-grapao-original-style

Available Variants

The build names follow the pattern with lowercase: wezterm-{artist}-{icon-name}

Examples:

• Build Mikker-Black → wezterm-mikker-black
• Build Gf3-Darkbrite-une → wezterm-gf3-darkbrite-une
• Build Grapao-Original-Style → wezterm-grapao-original-style

Refer to the table above to find your preferred icon, then install using the corresponding build name.