Skip to content

Windows executable has no embedded icon resource, causing missing icon when pinned to taskbar #348

Description

@m1sk9

Summary

The Windows executable (raphael_x86_64_windows.exe) does not appear to have an embedded icon resource. As a result, the taskbar icon is missing (shown as the generic Windows application icon) when the app is pinned to the taskbar, and the same generic icon is shown in Explorer / file properties.

The correct Raphael icon does appear briefly while the application is running, because the icon is set at runtime by the application itself (likely via eframe/egui viewport icon). However, since the executable has no static icon resource, Windows falls back to the generic icon for any context that reads the icon from the binary (Explorer, file properties, taskbar pinning).

Environment

  • OS: Windows 11
  • Raphael version: v0.28.1 (latest stable)
  • Binary: raphael_x86_64_windows.exe from GitHub Releases

Steps to Reproduce

  1. Download raphael_x86_64_windows.exe from the latest release.
  2. Right-click the executable and open Properties → the icon shown is the generic Windows app icon, not the Raphael logo.
  3. Launch the application. The taskbar briefly shows the correct Raphael icon (set by the running application).
  4. Right-click the taskbar icon and choose "Pin to taskbar".
  5. Close the application.
  6. The pinned taskbar entry shows the generic Windows icon, not the Raphael logo.
Image

The pinned taskbar entry (right) shows the generic Windows icon,
while the live window preview (set at runtime) shows the correct Raphael logo.

Expected Behavior

The Raphael logo should be shown consistently in Explorer, file properties, and when the executable is pinned to the taskbar.

Likely Cause

The executable is built without embedding an .ico resource into the PE file. For Rust projects, this is typically done via a build.rs using a crate like winres or embed-resource, gated on target_os = "windows".

Runtime icon assignment (e.g. ViewportBuilder::with_icon) only affects the live window — it does not affect Explorer or taskbar pinning, which read the icon from the binary's resource section.

Workaround

Users can create a shortcut to the executable, manually set its icon via Properties → Change Icon, and pin the shortcut instead.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions