QM  7.0.0
Model-Based Design Tool
Loading...
Searching...
No Matches
Downloading & Installing QM™

Getting StartedLaunching QM™

Downloading QM™ in QP™-Bundle

The most recommended way of getting QM™ is by downloading the QP-bundle™↑, which includes QM™ and also all QP™ Real-Time Embedded Frameworks↑ and the QTools™ collection↑. The main advantage of getting QM™ bundled together like that is that you get all components, tools and ready-to-use examples.

Remarks
QP-bundle™↑ is the most recommended way of downloading and installing QM™. However, if you are allergic to installers and GUIs or don't have administrator privileges you can also download and install QM™ separately as described below.

Downloading QM™ from GitHub

Go to the QM™ release page on GitHub↑, and choose the QM™ version number you wish to download. You should select the latest QM™ version, unless you have a very specific reason to go with an older release.

Inside the release directory (e.g., 6.1.2), you need to choose the QM™ archive for your platform. QM™ is available for Windows (qm_<ver>-win64.zip), Linux (qm_<ver>-linux64.zip), and MacOS (qm_<ver>-macx64.dmg).

QM downloads from GitHub

Installing QM™

Note
If you have any previous version of QM™ installed on your system, it is highly recommended to uninstall it before installing a newer version.

Installing QM™ on Windows

After downloading the ZIP archive for Windows (qm_<ver>-win64.zip), you can unzip the archive into any directory, although the C:\qp\ folder is the recommended default.

Remarks
It is generally not recommended to install QM™ in such Windows locations as "Program Files" or "Program Files (x86)", because these directories have access limitations and don't allow you to modify the QM Style Sheet (qm.qss) or new model templates.

If you wish, after the installation, you could create a desktop shortcut and you can also associate QM™ model files (*.qm and *.qmp) with the QM application (using the standard Windows Explorer and "Open With" popup menu).

To uninstall QM™ you simply delete the installation directory.

Installing QM™ on Linux

After downloading the ZIP archive for Linux (qm_<ver>-linux64.zip), you can unzip the archive into any directory, although the ~/qp/ folder is the recommended default.

After unzipping the archive, go to the qm/bin/ directory and make sure that the qm executable and the qm.sh shell script have executable permissions. You can either do this with your desktop's file manager or at the command line, type:

chmod u+x qm
chmod u+x qm.sh
Note
To run the QM application on Linux, you need to run the qm/bin/qm.sh script. Make sure that the file has executable permissions.

Manual Setup of QM Desktop Shortcut

The easiest way to launch QM™ is through the desktop shortcut. However, on some Linux desktops the provided QM setup program might not be able to install correctly. In most of such cases, you might still be able to create the desktop shortcut manually. The provided procedure should work for both KDE and GNOME desktops:

  1. Drag the file <qm>\bin\qm.desktop from the file explorer to the desktop:
Dragging the QM shortcut to the desktop
  1. Right-click on the desktop shortcut and choose "Icon Settings" (or sometimes Properties) from the popup menu. Set the application command to <qm>\bin\qm.sh script
Setting qm.sh script as shortcut command
  1. If you wish to set the QM icon for the shortcut, click on the image and browse inside <qm>\Resources\ folder:
Changing the icon for the QM shortcut
Note
To run the QM™ application on Linux, you need to run the <qm>/bin/qm.sh bash script instead of directly running the <qm>/bin/qm executable.

Installing QM™ on macOS

After downloading the qm_<ver>-macos.dmg disk image you need to change the file attributes of the .dmg file. Launch a console and change the attribute of this file:

xattr -c qm_<ver>-macos.dmg
Remarks
Because the .dmg file is not coming from the Apple Store, if you don't change the .dmg file attribute, you might get the following warning:

Only after changing the file attribute, you can install QM on your macOS. Double click on .dmg file. This will mount and open the disk image. To install the QM tool, you simply drag the qm.app image into the Applications folder (typically visible in the Dock). If you wish, you might also create the alias of the qm.app and place it on your Desktop.

QM setup for macOS

To uninstall QM, simply delete the qm.app file and the examples.

QM™ Installation Folder

The setup program installs QM™ executable and all shared libraries necessary to run the application. The following example shows directories and files installed on Windows (where &lt;qm&gt; denotes the folder where you chose to install QM™):


<qm>
+---bin/ // executables
| +---platforms/ // Platform plugin for Qt6
| | qminimal.dll
| | qwindows.dll
| |
| | qm.exe // QM application executable
| | . . .
| | Qt6Core.dll // Qt6 Core features DLL
| | Qt6Gui.dll // Qt6 GUI DLL
| | Qt6PrintSupport.dll // Qt6 Print DLL
| | Qt6Svg.dll // Qt6 SVG DLL
| | Qt6Widgets.dll // Qt6 Widgets DLL
| | . . .
|
+---html/ // HTML help
| | ~~~
| | index.html // HTML index file for all help topics
|
+---Resources/ // QM model templates
| +---qpc/ // templates for QP/C
| +---qpcpp/ // templates for QP/C++
| | qm_dark.qss // QM style sheet (dark color scheme)
| | qm_light.qss // QM style sheet (light color scheme)
|
| qm.xsd // XML Schema for the QM model XML
| QM_LICENSE.txt // QM license
| README.md // QM release notes
| unins000.exe // QM uninstaller (if QM installed separately)

QP™ Frameworks

If your only intention is to use QM™ as a drawing tool, you don't need to bother with QP™↑ or even know what it is. However, if you wish to use QM™ to its full potential for generating production-quality code, you need to install at least one of the QP™ frameworks (QP/C or QP/C++). The open source QP™ frameworks are available for download inside the QP-bundle™↑, which includes QM™ and also all QP™ Real-Time Embedded Frameworks↑ and the QTools™ collection↑ or separately, as described in the Reference Manuals of each framework.

Downloading & Installing QM™Launching QM™