WindeployQt

Point-and-click deployment for Qt apps on Windows.

A simple Qt GUI that wraps the windeployqt command-line tool in a visual interface. No terminal needed — browse your .exe, click Generate, and get all the required Qt DLLs bundled automatically.

---

Why WindeployQt?

The official windeployqt tool is powerful but lives in the terminal. If you just built a Qt app and want to share it, you shouldn't have to remember CLI flags. WindeployQt gives you a GUI to point, click, and deploy — nothing more.

"The best deployment tool is the one you actually use."

---

Features

Qt Widgets Deploy

Select your compiled .exe and click Generate. WindeployQt runs windeployqt on it and copies all required Qt DLLs, plugins, and resources into your project folder.

Qt Quick / QML Deploy

Working with QML? Select the QML Debug or QML Release radio button, then click Generate Qml. The tool appends --debug/--release and --qmldir flags automatically.

Persistent Configuration

The path to windeployqt.exe is saved to a config file (~/windeployConfig.appconfig). Set it once, and the app skips the setup screen on future launches.

Settings Reset

Go to Edit > Settings to reconfigure the windeployqt path, or Edit > Reset to clear the saved config entirely.

And more

• Menu bar — Browse, Quit, Settings, Reset, Minimize, About Qt
• Auto-detect mode — browsing a .exe in a /release or /debug folder auto-selects the matching QML radio button
• Status feedback — success/error messages after each deploy attempt

---

Quick Start

Prerequisites

• Windows OS
• Qt 5 (MinGW or MSVC kit)
• Qt Creator (recommended)

Build

1. Open WindeployQt.pro in Qt Creator
2. Select a desktop kit (Debug or Release)
3. Build and run

Run

1. On first launch, browse to your windeployqt.exe location (typically in your Qt installation under Tools/QtDeploymer/bin/windeployqt.exe)
2. Click Continue
3. Browse to your project's compiled .exe
4. Click Generate (Widgets) or select debug/release + Generate Qml (Qt Quick)

---

How it works

Browse for windeployqt.exe    Saved to ~/windeployConfig.appconfig
         ↓
Browse for project .exe       Path stored in memory
         ↓
Click Generate                Runs: windeployqt "<exe path>"
         ↓
Qt DLLs bundled               Output directory populated with dependencies

Config flow: First launch → setup wizard → config written. Subsequent launches → config read → skip straight to deploy screen.

---

Tech Stack

Layer	Tech
Framework	Qt 5 Widgets — cross-platform GUI toolkit
Language	C++11 — minimal, no external dependencies
Build	qmake — standard Qt build system
Deploy	windeployqt — official Qt deployment CLI tool

---

Project Structure

WindeployQt/
├── main.cpp              Entry point (QApplication)
├── mainwindow.cpp        All application logic
├── mainwindow.h          MainWindow class declaration
├── mainwindow.ui         Qt Designer UI (3-page stacked widget)
├── WindeployQt.pro       qmake project file
├── icons.qrc             Qt resource file
├── assets/
│   └── app.svg           Application icon
└── Readme.md

---

Configuration

Setting	Location	Description
windeployqt.exe path	~/windeployConfig.appconfig	One-line text file with the full path to windeployqt.exe

The config is read on startup and written when you complete the setup flow. Use Edit > Reset to clear it.

---

Contributing

1. Fork it
2. Create a branch (git checkout -b feat/my-thing)
3. Commit (git commit -m 'Add my thing')
4. Push (git push origin feat/my-thing)
5. Open a PR

---

License

No license file is included. All rights reserved by the author.

---

If WindeployQt saves you from typing CLI flags, give it a star.

It helps others find it, and tells me this is worth continuing.

⭐ Star this repo