qtchooser

qtchooser [--list-versions] [--print-env] [--run-tool tool --qt version] [--install name path]

qtchooser manages multiple Qt installations on a system. It allows developers to switch between different Qt versions (Qt4, Qt5, Qt6) for building applications.The tool wraps Qt development binaries (qmake, moc, uic, etc.) and directs them to the selected Qt installation based on configuration files or command-line options.

--list-versions

List available Qt versions

Print Qt environment variables

Run specified Qt tool

Select Qt version to use

Register a Qt installation

Short form of --qt, accepted directly on wrapper binaries (e.g. `qmake -qt=5`).

Short form of --run-tool.

Single-dash aliases of the corresponding long options.

/usr/share/qtchooser/

System-wide Qt version configuration files, each specifying bin and lib paths for a Qt installation.

User-level Qt version configuration files overriding system defaults.

Environment variable selecting the default Qt version (e.g., qt5, qt6).

Not all distributions use qtchooser; Debian/Ubuntu still do, but Fedora and Arch dropped the wrapper in favor of qualified binary names (`qmake-qt5`, `qmake6`). Qt 6 installations frequently do not register themselves — you may need to --install them manually.

qtchooser was created to handle the transition between Qt4 and Qt5 on Linux systems, allowing both versions to coexist while maintaining compatibility with build systems.

qmake(1), moc(1), qt-select(1)