QM  5.2.2
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.

Note
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., 5.1.3), you need to choose the QM™ archive for your platform. QM™ is available for Windows (qm_<ver>-win32.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>-win32.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.

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
Attention
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>-macx64.dmg disk image, double click on the .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 Mac OS X

To uninstall QM, simply delete the QM application from the Applications folder.

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 Qt5
| | +-qwindows.dll
| |
| +-qm.exe // QM application executable
| + . . . .
| +-Qt5Core.dll // Qt5 Core features DLL
| +-Qt5Gui.dll // Qt5 GUI DLL
| +-Qt5PrintSupport.dll // Qt5 Print DLL
| +-Qt5Widgets.dll // Qt5 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++
| +-qpn/ // templates for QP-nano
| +-qm.qss // QM style sheet (see Customizing QM)
|
+-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, QP/C++, or QP-nano). 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™