[Question]Windows: Packaged Flet app creates a separate "Flet description" taskbar window

[amin110110110]

Question

Bug: Packaged Flet app creates a separate "Flet description" taskbar window on Windows

Hello Flet team,

I am experiencing a Windows desktop packaging issue with my Flet application.

After packaging my Python + Flet application into an EXE and running it, the application itself works normally.

However, Windows Taskbar shows an additional application/window entry called:

"Flet description"

When I right-click the application icon on the Windows Taskbar, there is a separate entry for "Flet description".

If I click on that entry, Windows opens another completely separate blank white window.

This blank window is not part of my Python/Flet application.

The problem is that when I close my main application, this additional "Flet description" window/process remains open and I have to close it separately.

Expected behavior

I expect the packaged application to behave as a single Windows application:

• Only one Taskbar entry should exist.
• The Taskbar entry should use my application's name.
• Right-clicking the Taskbar icon should not show a separate "Flet description" application.
• Clicking the Taskbar entry should activate the existing application window.
• Closing the main application should terminate the complete application and all related Flet processes/windows.

Actual behavior

After packaging:

1. My application starts normally.
2. Windows creates an additional Taskbar entry called "Flet description".
3. Right-clicking the Taskbar icon shows this additional entry.
4. Clicking "Flet description" opens a blank white window.
5. This window is independent from my main application window.
6. Closing the main application does not close this additional window.
7. I have to close the additional window separately.

Environment

OS:
Windows 11 64-bit

Python:
[PLEASE ADD YOUR PYTHON VERSION]

Flet:
[PLEASE ADD YOUR FLET VERSION]

Packaging method:
[PLEASE ADD YOUR PACKAGING METHOD]

For example:
Nuitka / flet pack / flet build windows

Flet version can be obtained with:

pip show flet

Python version:

python --version

Important

I have already tried several approaches to solve this problem, including:

• flet pack
• flet build
• Nuitka
• changing Windows executable metadata
• changing the application icon
• modifying the Flet executable metadata with Resource Hacker
• rebuilding the application after making these changes

None of these approaches resolved the issue.

The problem appears to be related to the Flet Windows desktop runtime / Flutter client / taskbar process association rather than my application UI code.

I have attached screenshots showing the behavior.

Could you please help me identify:

1. Why Windows is creating a separate Taskbar entry for "Flet description"?
2. Which Flet executable/process is responsible for this additional window?
3. How can the packaged application be configured so that the Flet runtime uses the same AppUserModelID / taskbar identity as the main application?
4. How can I ensure that closing the main Flet application also terminates the related Flet runtime process?
5. Is this a known issue in my Flet version?
6. Is there a recommended packaging configuration for Windows that completely prevents this behavior?

Thank you.

Hello Flet team,

I have a Windows Flet application packaged as an EXE.

After running the packaged application, Windows shows an additional Taskbar entry called "Flet description". Clicking it opens a separate blank white window that is completely independent from my main application.

When I close my main application, this extra window remains open and must be closed separately.

I have already tried all the suggested solutions, including:

• flet pack
• flet build
• Nuitka
• changing EXE metadata and icon
• modifying the Flet runtime executable with Resource Hacker
• rebuilding the application

Unfortunately, none of these solutions fixed the problem.

I believe this may be related to the Flet Windows runtime / Taskbar process handling.

Could you please help me identify the correct solution?

I can provide screenshots, my Flet version, Python version, and packaging command if needed.

Thank you.

Code sample

No response

Error message

No response

------------------------------------------------------

• I have searched for answers to my question both in the issues and in previous discussions.

[ndonkoHenri]

flet build doesnt have an issue - i tested it to confirm.
But flet pack does, and I am just from opening a PR to address it: #6793