Developers using PyInstaller to package a PyQt5 app often forget to include the platforms folder. The resulting .exe works on their dev machine but crashes on a client's PC with the plugin error.

Solution: Distribute your own repack – simply zip the platforms folder and unzip it next to the .exe during installation. This is the safest "repack" in existence.

There are two ways to fix the application using your repack:

Method A (Standard Deployment): Copy your platforms folder (containing qwindows.dll) into the same directory where the application’s .exe file lives. For example: C:\Program Files\BrokenApp\app.exe C:\Program Files\BrokenApp\platforms\qwindows.dll

Method B (Using Environment Variables – No administrator rights needed): If the app loads a different, broken Qt version from the PATH environment variable, use:

set QT_QPA_PLATFORM_PLUGIN_PATH=C:\My_Qt_Repack\platforms

Then launch the application from the same command prompt.

Ask the user to run the application with:

set QT_DEBUG_PLUGINS=1
myapp.exe

Expected output includes:

Found metadata in lib C:\...\platforms\qwindows.dll, metadata=
"IID": "org.qt-project.Qt.QPA.QPlatformIntegrationFactoryInterface.5.3",
    "keys": [ "windows" ]

The term "repack" historically refers to compressed, re-packaged software distributions (often from warez groups). However, in the context of Qt debugging, a "qt platform plugin download repack" usually means one of three things:

Frustrated, Alex called Jordan over. Jordan smiled and pulled up a chair.

“Ah, the classic platform plugin error,” Jordan said. “Qt doesn’t just need its core DLLs. It needs a small but crucial piece called the platform plugin—usually qwindows.dll on Windows, libqcocoa.dylib on macOS, or libqxcb.so on Linux. That plugin tells Qt how to talk to the operating system’s windowing system.”

“So I’m missing qwindows.dll?” Alex asked.

“Exactly. And Qt looks for it inside a specific folder structure: platforms/qwindows.dll relative to your executable.”

Qt Platform Plugin Download Repack

Developers using PyInstaller to package a PyQt5 app often forget to include the platforms folder. The resulting .exe works on their dev machine but crashes on a client's PC with the plugin error.

Solution: Distribute your own repack – simply zip the platforms folder and unzip it next to the .exe during installation. This is the safest "repack" in existence.

There are two ways to fix the application using your repack:

Method A (Standard Deployment): Copy your platforms folder (containing qwindows.dll) into the same directory where the application’s .exe file lives. For example: C:\Program Files\BrokenApp\app.exe C:\Program Files\BrokenApp\platforms\qwindows.dll qt platform plugin download repack

Method B (Using Environment Variables – No administrator rights needed): If the app loads a different, broken Qt version from the PATH environment variable, use:

set QT_QPA_PLATFORM_PLUGIN_PATH=C:\My_Qt_Repack\platforms

Then launch the application from the same command prompt.

Ask the user to run the application with: Developers using PyInstaller to package a PyQt5 app

set QT_DEBUG_PLUGINS=1
myapp.exe

Expected output includes:

Found metadata in lib C:\...\platforms\qwindows.dll, metadata=
"IID": "org.qt-project.Qt.QPA.QPlatformIntegrationFactoryInterface.5.3",
    "keys": [ "windows" ]

The term "repack" historically refers to compressed, re-packaged software distributions (often from warez groups). However, in the context of Qt debugging, a "qt platform plugin download repack" usually means one of three things:

Frustrated, Alex called Jordan over. Jordan smiled and pulled up a chair. Then launch the application from the same command prompt

“Ah, the classic platform plugin error,” Jordan said. “Qt doesn’t just need its core DLLs. It needs a small but crucial piece called the platform plugin—usually qwindows.dll on Windows, libqcocoa.dylib on macOS, or libqxcb.so on Linux. That plugin tells Qt how to talk to the operating system’s windowing system.”

“So I’m missing qwindows.dll?” Alex asked.

“Exactly. And Qt looks for it inside a specific folder structure: platforms/qwindows.dll relative to your executable.”

Apuntarme al newsletter