Skip to main content

Another unofficial Qt installer

Project description

Jobs Mac Linux Windows Mirror Release Status
Status macos ubuntu windows ext pypi pep8 docs

This is an utility replacing the official graphical Qt installer. It can automatically download prebuilt Qt binaries for any target (you’re not bound to Linux binaries on Linux; you could also download iOS binaries). It’s working with Python > 3.5 on Linux, OS X and Windows. It is required to install 7zip utility in your platform.


Same as usual, it can be installed with pip

$ pip install aqtinstall


General usage looks like this:

aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>][-E | --external <7zip command>] \
    [--internal] install <qt-version> <host> <target> [<arch>] -m [extra module] [extra module]...
python -m aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>][-E | --external <7zip command>] \
    [--internal] install <qt-version> <host> <target> [<arch>] -m [extra module] [extra module]...
  • The Qt version is formatted like this: 5.11.3
  • Host is one of: linux, mac, windows
  • Target is one of: desktop, android, ios (iOS only works with mac host)
  • For some platforms you also need to specify an arch:
    • For windows, choose one of: win64_msvc2017_64, win32_msvc2017, win64_msvc2015_64, win32_msvc2015, win64_mingw73, win32_mingw73, win64_mingw53, win32_mingw53, win64_msvc2017_winrt_x64, win64_msvc2017_winrt_x86, win64_msvc2017_winrt_armv7
    • For android and Qt 5.13 or below, choose one of: android_x86_64, android_arm64_v8a, android_x86, android_armv7
  • You can also use internal 7zip extractor instead of external 7zip command.
  • You can specify external 7zip command path.
python -m aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>][-E | --external <7zip command>] \
    [--internal] tool <host> <tool_name> <tool-version> <arch> -m [extra module] [extra module]...
  • tool_name is one of tools_ifw, tools_vcredist, and tools_openssl.
  • arch is full qualified tool name such as

The Qt packages are installed under current directory as such Qt/<ver>/gcc_64/ If you want to install it in C:Qt as same as standard gui installer default, run such as follows:

C:\> mkdir Qt
C:\> aqt install --outputdir c:\Qt 5.11.3 windows desktop win64_msvc2017_64

Example: Installing Qt SDK 5.12.0 for Linux with QtCharts and QtNetworkAuth:

pip install aqtinstall
sudo aqt install --outputdir /opt 5.12.0 linux desktop -m qcharts qtnetworkauth

Example: Installing Android (armv7) Qt 5.10.2:

aqt install 5.10.2 linux android android_armv7

Example: Install Install FrameWork(IFW):

aqt tool linux tools_ifw 3.1.1

Example: Install vcredist:

C:\ aqt tool windows tools_vcredist 2019-02-13-1
C:\ .\Qt\Tools\vcredist\vcredist_msvc2017_x64.exe /norestart /q

Example: Install OpenSSL:

C:\ aqt tool windows tools_openssl 1.1.1-1

Example: Show help message

aqt help

Supported CI platform

There are no limitation for CI platform but currently it is tested on Azure Pipelines.


This program is originally shown in Kaidan project as a name qli-installer. A project aqtinstall extend the original to run with standard python features with Linux, Mac and Windows, to be tested on CI platform, and to improve performance with a concurrent downloading.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aqtinstall, version 0.6
Filename, size File type Python version Upload date Hashes
Filename, size aqtinstall-0.6-py2.py3-none-any.whl (16.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size aqtinstall-0.6.tar.gz (41.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page