QM macro list files

All items that you see in the left side of the QM window are saved to a QM macro list file. When QM starts, it loads the last used file. QM macro list files have the ".qml" extension and are opened with qm.exe.

When you open other file or exit QM, QM ends running threads, closes toolbars, deletes all global variables, user-defined functions and declarations of all user-defined identifiers.

Shared files

A macro list can have one or more folders that every time are filled with external QM macro list file items. To add a shared folder, use menu File -> Import.

Shared-folder items do not belong to the main file. To edit them, you should open the shared file separately or as part (normal folder) of other file. Otherwise, changes will not be saved, unless you export the shared folder.

Functions, that are in the System folder, have higher priority. If there are two functions with the same name, is used the function from the System folder.

If a shared file is on another computer, and it is initially not accessible, QM silently loads it when it becomes accessible (the main file then is not reloaded). Or, QM can wait for a shared file before starting.

Installed files

Quick Macros comes with several macro-list files:

$my qm$\Main.qml (Main.qml in My Documents\My QM folder) - macro list file that was automatically set as your main macro list file when QM was installed first time. This file is not replaced when upgrading QM, and therefore you can use (and probably are using) it as your main file. All other files listed below are replaced when upgrading QM, and therefore you should not use them as your main file. You can use them as shared files, or import, or import only some macros from them.

$qm$\Installed Files\Main.qml - original Main.qml file that comes with the QM version you currently have installed.

$qm$\System.qml - QM extensions. This file is automatically added to your list of macros as shared file (System folder). Should never by opened as main file.

$qm$\Installed Files\Play Demo.qml - macros that run when you click Play Demo links in the Tips pane.

Notes:

$qm$ - folder where QM is installed. Probably C:\Program Files\Quick Macros 2.
$my qm$ - your personal folder for QM files. By default, it is ...\My Documents\My QM.

You can find more files in the QM forum.

How to transfer Quick Macros, along with macros and other QM data, to another computer

To transfer Quick Macros from computer A to computer B:

1. Install Quick Macros on B.
2. Make sure Quick Macros on B is not running. If running, exit (menu File -> Exit program).
3. On computer A, locate My QM folder. It is in My Documents, unless you changed it in Options.
4. Copy the My QM folder to My Documents on B. If My QM already exists there, at first delete it.
5. If your macro file on A is not in My QM, copy it to B too. You can see your macro file path in menu File -> Recent -> first entry.
6. Run Quick Macros on B.
7. If it did not open your file, open it using menu File -> Open/New File.

File Viewer

When opening an unknown QM macro list file, at first it is opened in the File Viewer. It allows you to safely preview file content. Then you can open, import, add as shared file, or cancel. Downloaded files may contain malicious, incompatible (duplicate functions, triggers, etc) or useless code. If you think the file is unsafe or useless, you can cancel. Or, you can import it with disabled triggers. Also, you can import only selected items.

The File Viewer also is used to preview the file when importing, to restore deleted items, to restore items from the backup folder, to view other files, to find an item in multiple files in a folder.

A file is considered unknown if it isn't in the recent file list (menu File -> Recent). Files from the Internet cache (downloaded files) and from the temporary folder (where usually files are extracted from zip archives) are always considered unknown. An unknown file is not opened in the File Viewer only if the command line tells QM to run a macro from the file (L "file" M "macro").

Tip: when in the File Viewer you check/uncheck a folder, all child items are automatically checked/unchecked. To prevent this, hold down Ctrl.