Skip to content

Commit 11f95e3

Browse files
AtmanActiveclaude
andcommitted
Add README section on replacing the executable icon
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent b1886b7 commit 11f95e3

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -148,6 +148,28 @@ The binary will be at `src-tauri/target/release/app` (or `app.exe` on Windows).
148148
└── config.rs # Config struct + loader
149149
```
150150

151+
## Replacing the Executable Icon
152+
153+
By default, the `.exe` file ships with the Tauri icon. To give your wrapped app its own identity in the taskbar and file explorer, you can replace the embedded icon using a resource editor.
154+
155+
### Recommended tools
156+
157+
| Tool | Type | Description |
158+
|------|------|-------------|
159+
| [Resource Hacker](https://www.angusj.com/resourcehacker/) | Free, portable | The standard tool for editing Windows PE resources. Open the `.exe`, go to **Icon Group**, right-click → **Replace Icon**, pick your `.ico` file, and save |
160+
| [Greenfish Icon Editor Pro](http://greenfishsoftware.org/gfie.php) | Free, open-source | Full icon editor — import a PNG, export as multi-size `.ico` |
161+
| [IcoFX](https://icofx.ro/) | Shareware | Feature-rich icon editor with PNG-to-ICO conversion |
162+
| [ImageMagick](https://imagemagick.org/) | Free, open-source, CLI | Convert from the command line: `magick convert icon.png icon.ico` |
163+
164+
### Steps
165+
166+
1. **Create an `.ico` file** from your PNG using one of the tools above (ideally include 16x16, 32x32, 48x48, and 256x256 sizes)
167+
2. **Open the `.exe`** in Resource Hacker
168+
3. Navigate to **Icon Group** → right-click → **Replace Icon** → select your `.ico` file
169+
4. **Save** the modified `.exe`
170+
171+
> **Note**: This replaces the icon shown in File Explorer and the taskbar. The window icon at runtime can also be set via the `icon` field in your JSON config — both approaches can be used together.
172+
151173
## License
152174

153175
[MIT](LICENSE) © AtmanActive

0 commit comments

Comments
 (0)