What keys can be sent using Macro Snippets?

The following table lists the keys that can be inserted in Snippets of type Macro (each key name must be enclosed in braces). See: How do I create a macro Snippet to send special keys to applications or insert pauses when pasting?

These keys are defined by the scripting language AutoHotkey (AHK). See more info about AHK at the end of the page.

These special keys are always enclosed between curly brackets, for example {Backspace}. For this reason, as explained in AutoHotkey documentation, if whenever you need to enter opening or closing curly brackets in your snippet, you will have to enclose them that way: {{} and {}}.

Key Modifiers

The modifiers !+^# affect only the very next key. To send the corresponding modifier key on its own, enclose the key name in braces. To just press (hold down) or release the key, follow the key name with the word “down” or “up” as shown below.

Symbol Key Press Release Examples
! {Alt} {Alt down} {Alt up} !a presses Alt+A
+ {Shift} {Shift down} {Shift up} +abC sends the text “AbC”
!+a presses Alt+Shift+A
^ {Ctrl} {Ctrl down} {Ctrl up} ^{Home} presses Control+Home
# {LWin}
{RWin}
{LWin down}
{RWin down}
{LWin up}
{RWin up}
#e holds down the Windows key and then presses the E key
Symbol Meaning
{ } Braces are used to enclose key names and other options, and to send special characters literally. For example, {Tab} is the Tab key and {!} is a literal exclamation mark.

Note: As capital letters are produced by sending the Shift key, A produces a different effect in some programs than a. For example, !A presses Alt+Shift+A and !a presses Alt+A. If in doubt, use lowercase.

Special Keys

 Key  
{F1} – {F24} Function keys. For example: {F12} is the F12 key.
{!} !
{#} #
{+} +
{^} ^
{{} {
{}} }
{Enter} Enter key on the main keyboard
{Escape} or {Esc} Escape
{Space} Space (this is only needed for spaces that appear either at the beginning or the end of the string to be sent — ones in the middle can be literal spaces)
{Tab} Tab
{Backspace} or {BS} Backspace
{Delete} or {Del} Delete
{Insert} or {Ins} Insert
{Up} (up arrow) key on main keyboard
{Down} (down arrow) key on main keyboard
{Left} (left arrow) key on main keyboard
{Right} (right arrow) key on main keyboard
{Home} Home key on main keyboard
{End} End key on main keyboard
{PgUp} PageUp key on main keyboard
{PgDn} PageDown key on main keyboard
   
{CapsLock} CapsLock
{ScrollLock} ScrollLock
{NumLock} NumLock
   
{Control} or {Ctrl} Control
{LControl} or {LCtrl} Left Control key
{RControl} or {RCtrl} Right Control key
{Control down} or {Ctrl down} Holds the Control key down until {Ctrl up} is sent. To hold down the left or right key instead, use {RCtrl down} and {RCtrl up}.
   
{Alt} Alt
{LAlt} Left Alt key
{RAlt} Right Alt key (or AltGr, depending on keyboard layout)
{Alt down} Holds the Alt key down until {Alt up} is sent. To hold down the left or right key instead, use {RAlt down} and {RAlt up}.
   
{Shift} Shift
{LShift} Left Shift key
{RShift} Right Shift key
{Shift down} Holds the Shift key down until {Shift up} is sent. To hold down the left or right key instead, use {RShift down} and {RShift up}.
   
{LWin} Left Win key
{RWin} Right Win key
{LWin down} Holds the left Win key down until {LWin up} is sent
{RWin down} Holds the right Win key down until {RWin up} is sent
   
{AppsKey} Menu key (invokes the right-click or context menu)
{Sleep} Sleep key.
{ASC nnnnn} Sends an Alt+nnnnn keypad combination, which can be used to generate special characters that don’t exist on the keyboard. To generate ASCII characters, specify a number between 1 and 255. To generate ANSI characters (standard in most languages), specify a number between 128 and 255, but precede it with a leading zero, e.g. {Asc 0133}.

Unicode characters may be generated by specifying a number between 256 and 65535 (without a leading zero). However, this is not supported by all applications. For alternatives, see the virtual key and scan code below.

{vkXX}
{scYYY}
{vkXXscYYY}
Sends a keystroke that has virtual key XX and scan code YYY. For example: Send {vkFFsc159}. If the sc or vk portion is omitted, the most appropriate value is sent in its place.

 

   
{Numpad0} – {Numpad9} Numpad digit keys (as seen when NumLock is ON). For example: {Numpad5} is 5.
{NumpadDot} . (numpad period) (as seen when NumLock is ON).
{NumpadEnter} Enter key on keypad
{NumpadMult} * (numpad multiplication)
{NumpadDiv} / (numpad division)
{NumpadAdd} + (numpad addition)
{NumpadSub} - (numpad subtraction)
   
{NumpadDel} Delete key on keypad (this key and the following Numpad keys are used when NumLock is OFF)
{NumpadIns} Insert key on keypad
{NumpadClear} Clear key on keypad (usually the ‘5’ key when NumLock is OFF).
{NumpadUp} (up arrow) key on keypad
{NumpadDown} (down arrow) key on keypad
{NumpadLeft} (left arrow) on keypad
{NumpadRight} (right arrow) key on keypad
{NumpadHome} Home key on keypad
{NumpadEnd} End key on keypad
{NumpadPgUp} PageUp key on keypad
{NumpadPgDn} PageDown key on keypad
   
{Browser_Back} Select the browser “back” button
{Browser_Forward} Select the browser “forward” button
{Browser_Refresh} Select the browser “refresh” button
{Browser_Stop} Select the browser “stop” button
{Browser_Search} Select the browser “search” button
{Browser_Favorites} Select the browser “favorites” button
{Browser_Home} Launch the browser and go to the home page
{Volume_Mute} Mute/unmute the master volume.
{Volume_Down} Reduce the master volume.
{Volume_Up} Increase the master volume.
{Media_Next} Select next track in media player
{Media_Prev} Select previous track in media player
{Media_Stop} Stop media player
{Media_Play_Pause} Play/pause media player
{Launch_Mail} Launch the email application
{Launch_Media} Launch media player
{Launch_App1} Launch user app1
{Launch_App2} Launch user app2
   
{PrintScreen} Print Screen
{CtrlBreak} Ctrl+break
{Pause} Pause

About AutoHotkey

These keys are defined by the scripting language AutoHotkey (AHK) used to develop Quick Access Popup. In QAP Macro Snippets, these keys are sent using the AHK command Send in Input mode. If the command SetKeyDelay is used in a macro snippet, the mode is changed to Event to allow the delay.

See also: How do I create a macro Snippet to send special keys to applications or insert pauses when pasting?

Can I call the Quick Access Popup menu from an AutoHotkey macro?

Yes, but there is small trick you need to know.

First, for those not familiar with AutoHotkey (AHK): this is the programming language used to develop Quick Access Popup. It is also a macro scripting tool. AHK developers could write scripts in which they could integrate a call to open QAP menu by “sending” the QAP menu hotkey (by default Middle mouse button) as if it was pressed by the user.

To call an AHK hotkey in one script from another script using the Send command, in some situations, you must insert the SendLevel, 1 command before the Send command. For example, the script below will call the QAP menu (assuming the mouse trigger for QAP is the default Middle Mouse Button).

#NoEnv
#NoTrayIcon
#SingleInstance Off
SendLevel, 1
Send, {MButton}

If you remove the SendLevel, 1 line, the call will not work. For more info about SendLevel, see AHK doc.

Can a submenu be shared on different PCs or by different users?

Yes. Shared menus allow to manage favorites in a setting file that can be shared by different users or used by the same user on different computers. The Shared menu settings file can be saved on a network drive or a shared folder (like Dropbox) and used on different PCs. Add a Shared menu from the Add Favorite dialog box. In the Shared Menu tab, select the type of usage of this shared menu:

Notes:

  • A Shared menu can contain any type of favorites, except other Shared menus.
  • Shortcuts associated to favorites in Shared menu are saved in the Shared menu itself. However, if the same shortcut is used in more than one favorite in different files, only one of these favorite shortcuts will be active.
  • If favorites in a Shared menu are saved on a cloud drive folder (like DropBox), you can use user variables (like {Dropbox}) if the cloud drive root directory is not at same locations on the various systems of the shared menu users.
  • Even if QAP provides protection against synchronization conflicts (when users are editing a menu at the same time), syncing issues may (rarely) occur for users working on cloud synchronization platforms like Dropbox or Google Drive that cannot accomplish full real-time syncing.
  • Users sharing menu on cloud shared drives working in different time zones should use QAP v9.0.6 (or more recent) that support sharing in different time zones.
  • Users sharing menus on network drives do not face sync or time zone issues because the shared menu file time stamp is read from the file itself.
  • Each time a Shared menu is modified and saved, a daily backup of the settings file is created with a suffix including the date of the backup, for example FileName-backup-20180812.ini; the five last backup files are kept and the older ones are deleted; backups are saved in the same folder where is kept the Shared menu file unless a backup folder is set by entering the value BackupFolder= (for example, BackupFolder=X:\SharedMenu\Backups) under the [Global] section of the Shared menu file.

 

Can a submenu be used by the same user on different system using a personal shared folder?

Yes. Personal shared menus allow you to keep some of your favorites in a menu setting file that could be accessed on different PCs using file synchronization tool (like Dropbox) or a network drive.

Note: See notes and other types of shared menus: Can a submenu be shared on different PCs or by different users?

Adding a Personal Shared Menu

  1. To create or add a shared menu, in the Add Favorite dialog box, select Shared Menu and press Continue.
  2. In the Shared menu settings file location, enter the path and file name of the external settings file. File extension must be .ini. If the settings file already exists, its content will be added to your popup menu. If it does not exist, it is created as an empty submenu.
  3. In the Short name for menu text zone, enter or edit the name of the new submenu if required.
  4. In the Shared Menu tab, select Personal.
  5. Set Menu Options as usual and save the new favorite.

Conflicts management
In Personal mode, Quick Access Popup alerts you if:

  • changes to your shared menu were left unchanged on another of your computers;
  • your menu was updated on another PC since you refreshed QAP (shared menus are refreshed when you open the Customize window and, again, when you open a Shared menu in the Customize window).

Can a submenu be shared as a team or workgroup collaborative tool?

Yes. Shared menus is an easy and convenient way for teams and workgroups to share links to documents, applications, folders, text snippets or any other resource. Designed for collaboration, any user having access to the shared menu can add or update favorites or submenus. The shared menu file can be saved on a network drive or a shared folder using a file synchronization tool (like Dropbox). QAP fully supports collaborative work avoiding modification conflicts.

Note: See notes and other types of shared menus: Can a submenu be shared on different PCs or by different users?

Adding a Collaborative Shared Menu

  1. To create or add a shared menu, in the Add Favorite dialog box, select Shared Menu and press Continue. If the Shared Menus Catalogue is enabled, you are offered to add a menu from the catalogue (you can also add a shared menu or create a new shared menu regardless of the catalogue by clicking the Add another shared menu… button).
  2. In the Shared menu settings file location, enter the path and file name of the external settings file. File extension must be .ini. If the settings file already exists, its content will be added to your popup menu. If it does not exist, it is created as an empty submenu.
  3. In the Short name for menu text zone, enter or edit the name of the new submenu if required.
  4. For a new shared menu, in the Shared Menu tab, select Collaborative and enter the shared menu name (this info is saved in the shared menu file itself for future users of this menu).
  5. If you share your menu on a cloud drive (like Dropbox, Google Drive or OneDrive), select the option Could drive to make sure QAP takes time zones difference into account when checking if a menu has been modified by another user since it was loaded on your system.
  6. Set Menu Options as usual and save the new favorite.

Quick Access Popup offer teams and groups of users collaborative features allowing to benefits from the favorites found and maintained by co-workers. Quick Access Popup prevents the current user to overwrite changes done by another user since its QAP menu was loaded. To avoid Collaborative Shared menu files modifications conflicts, Quick Access Popup alerts you if:

  • another user is making changes to the menu;
  • your menu was updated by another user since you refreshed QAP (external menus are refreshed when you open the Customize window and, again, when you open a Shared menu in the Customize window).

Can a submenu be managed by a menu administrator for the benefit of read-only users?

Yes. Shared menus is an easy and convient way for a person or group in managing information for their colleagues to distribute links to documents, applications, folders or any other resource. Designed for controled management, a centralized shared menu is read-only for all users except those configured as menu administrators. The shared menu file can be saved on a network drive or a shared folder using a file synchronization tool (like Dropbox). Of course, users having write-access to the shared menu settings file could edit it using a text editor.

Note: See notes and other types of shared menus: Can a submenu be shared on different PCs or by different users?

Adding a Centralized Shared Menu

  1. To create or add a shared menu, in the Add Favorite dialog box, select Shared Menu and press Continue. If the Shared Menus Catalogue is enabled, you are offered to add a menu from the catalogue (you can also add a shared menu or create a new shared menu regardless of the catalogue).
  2. In the Shared menu settings file location, enter the path and file name of the external settings file. File extension must be .ini. If the settings file already exists, its content will be added to your popup menu. If it does not exist, it is created as an empty submenu.
  3. In the Short name for menu text zone, enter or edit the name of the new submenu if required.
  4. For a new shared menu, in the Shared Menu tab, select Centralized and enter the shared menu settings (this info is saved in the shared menu file itself for future users of the menu):
    • Shared menu name;
    • Users with write access to this shared menu: enter one or multiple Windows logon names separated by comma;
    • Shared menu write access message: message displayed to read-only users when they try to edit the shared menu.
  5. Set Menu Options as usual and save the new favorite.

When read-only users try to edit a centralized shared menu, the write access message is displayed. Here is an example:

Only menu administrators named in the Users with write access to this shared menu text box can edit the content of the shared menu. If more than one user have this privilege, Quick Access Popup prevents the current user to overwrite changes done by another administrator since its QAP menu was loaded. It avoids files modifications conflicts and alerts you if:

  • another administrator is making changes to the menu;
  • the centralized menu was updated by another administrator since you refreshed QAP (external menus are refreshed when you open the Customize window and, again, when you open a Shared menu in the Customize window).

Generating a shared menu

If you want to generate a Shared menu settings file from an external application, see the structure of the favorites in a settings file and important instructions: What is the content of a shared menus settings file (for advanced users)? See also: What is the structure of QAP settings (ini) file?

Important note: the last file modification date-time is stored in the shared ini file in the [Global] value LastModified in “yyyymmddhh24miss” format (for example “20191004224941”). This value should be updated if the content of a centralized shared menu file is changed outside QAP by an administrator or by an automatic process.

 

What is the content of a shared menus settings file (for advanced users)?

Each shared menu settings file is saved in a separate .ini files stored on a shared drive or folder. User can add a shared menu using the Add Favorite command. The info about the added shared menu is stored in the user’s QuickAccessPopup.ini file in a line like this:

Favorite1=External|HR Menu|> HR Menu|C:IconsJLicons.dll,42||C:SharedMenusHR_Menu.ini||||||||0||||||

Anatomy of a shared menu settings file

Users having access to the shared menu ini file on a network drive or shared folder (Dropbox, etc.) can manage the shared menu in a text editor. They can also be generated from an external data source. If you edit or generate a settings file, make sure its content is fully compliant with the QAP structure because little or no validation is done when QAP loads a settings file. QAP assumes that the settings file contains valid data as if it was saved by QAP itself.

The shared menu settings file is composed of three sections:

  • [Global]: information about the shared menu
  • [Favorites]: the list of favorites shared in this menu
  • [Favorites-backup]: a backup of the favorites as they were before the last time the shared menu was saved

Here is an example of a shared menu. Its content is detailed below.

[Global]
MenuName=HR Resources Menu
WriteAccessUsers=Mary,Jean
WriteAccessMessage=Please contact Mary at HR for suggestions about the HR shared menu.
MenuReservedBy=
MenuType=3
LastModified=20191004093906
BackupFolder=X:\SharedMenus\Backups
[Favorites-backup]
Favorite1=...
Favorite2=...
Favorite3=Z
[Favorites]
Favorite1=...
Favorite2=...
Favorite3=...
Favorite4=Z

[Favorites] section

The shared favorites are listed in the [Favorites] section in the order they are saved and loaded by QAP. The details of the favorites structure is the same as for the user’s QuickAccessPopup.ini file. You can find more info about the favorites in a settings file here: What is the structure of QAP settings (ini) file?

[Global] section

The content of the [Global] section depends on the type of shared menu. The four first values are common to all types of shared menus:

MenuType=

  1. Personal (default)
  2. Collaborative
  3. Centralized

MenuName=
The shared menu name is shown in various dialog boxes and used as default name when user adds the shared menu from the Shared Menus Catalogue.

LastModified=
The last modified date-time is used to detect if a shared menu file was modified by another user since the QAP menu was loaded. This prevents the user to edit the menu based on an older version of its content.

When saved on a network drive, the last modification date-time of the shared menu ini file is taken from the file system and is independent from various user’s clocks or time zones. Of course, the date-time being written to the file right after its modification, the real file’s date-time can be a few milliseconds after the value saved in the file but this will not impact the conflict protection.

But if the shared menu file is saved on a cloud drive, the last modification date-time of the shared menu ini file is taken from the PC’s clock in the Coordinated Universal Time (UTC). These PCs clock should be kept as sync as much as possible.

In both cases (network or cloud drive), the time is stored in the “yyyymmddhh24miss” format with the addition of the “UTC” when suffix when saved on a cloud drive (more info about date-time format in AHK documentation).

The file modification date-time in the ini file is updated only when changes are done to the content itself (shared favorites), not for actions modifying the file’s date-time without real modifications in the content. This value must be updated if the content of the shared menu file is changed outside QAP by an administrator using a text editor or by an automatic process.

MenuReservedBy=
This value is used to track current editing of a shared menu. If this value is empty, the menu is not currently reserved. When the menu is edited, it is flagged as reserved by setting the value to the Windows logon name and computer name of the user currently editing the shared menu (you can find the current user’s logon name in the QAP About dialog box).

The shared menu is released and the value of MenuReservedBy is erased when the user who reserved the menu saves or cancels the changes to the Shared menu, or quits QAP. This value can be erased manually by an administrator if, for any reason, a file is locked by a user who could not access the file using QAP.

This value is critical to collaborative shared menus where the risk of simultaneous editing is more likely to occur. But it is also used to alert a personal shared menu user if the menu was left unsaved on another PC and to alert administrator of a centralized menu if another administrator is currently editing the menu.

The last two values are specific to Centralized shared menus:

WriteAccessUsers=
Only users listed in this value can edit a centralized shared menu. Enter one or multiple Windows logon names, separated by comma. Note: of course, any user having write-access to the shared menu settings file itself could edit it using a text editor.

WriteAccessMessage=
This is the message displayed to user having only read-only access to a centralized menu when they try to edit the menu with QAP. It can be used to direct the user to the menu administrator.

BackupFolder=
Each time a Shared menu is modified and saved, a daily backup of the settings file is created with a suffix including the date of the backup, for example FileName-backup-20180812.ini; the five last backup files are kept and the older ones are deleted; backups are saved in the same folder where is kept the Shared menu file unless a backup folder is set by entering the value BackupFolder.

Personal shared menu example

[Global]
MenuType=1
MenuName=My Personal Menu
LastModified=20191004224941

Collaborative shared menu example

for a menu saved on a network drive

[Global]
MenuType=2
MenuName=Team Shared Menu
MenuReservedBy=
LastModified=20191004224941

for a menu saved on a cloud drive

[Global]
MenuType=2
MenuName=Team Shared Menu
MenuReservedBy=
LastModified=20191005024941UTC

Centralized shared menu example

[Global]
MenuType=3
MenuName=HR Toolkit Menu
WriteAccessUsers=Peter,Paul,Mary
WriteAccessMessage=Please forward suggestions to Peter, Paul or Mary.
MenuReservedBy=
LastModified=20191004224941

Can I create a catalogue of shared menus for my team or workgroup?

The Shared Menus Catalogue is a repository of Shared Menu files managed by menu administrators or by other workgroup members (more info on Shared Menus). It is designed to facilitate the addition of shared menus by users.  The settings files (.ini files) in the catalogue are located on a shared network drive. They can stay in the root folder or they can be saved in subfolders for clarity or in order to manage various access rights. But all settings files will be displayed as one sortable list.

If the Shared Menus Catalogue is enabled (see below how to enable it) when adding a Shared menu, the user is offered to select an existing Shared menu file from the repository and click the button Add selected shared menu(s). User can click list headers to sort the catalogue by menu name or by menu settings file path. User can also add any other shared menu or create a new shared menu regardless of the Catalogue by clicking on the button Add another shared menu.

User can double-click on a catalogue line to view the clicked shared menu info (menu name, type, owners, etc). Users having write access to the shared menu file (Mary and Jean, in this example) see the Open shared menu file? prompt allowing them to edit the shared menu properties in the ini file (of course, users also need network write access to the containing folder).

Enabling the Shared Menus Catalogue

The catalogue can be enabled in the Options dialog box (Various Advanced Options tab) by checking Enable Shared Menus Catalogue checkbox and by entering the path of the Catalogue root folder.

 

System administrator could also edit the users’ QuickAccessPopup.ini files (see How can I edit the file QuickAccessPopup.ini?) and, for each user, enter these values under the [Global] section:

ExternalMenusCataloguePath=
Path to the catalogue root on a shared drive (as entered in the Options dialog box).

ExternalMenusCataloguePathReadOnly=1
This variable set to “1” can prevent the user from enabling/disabling the catalogue or changing its path in the Options dialog box (of course, user could still change it in its own personal QuickAccessPopup.ini file).

For future users, the admin can also add these values in the ini file template used to create new users settings file. More info here: Are administrator rights required to install QAP?

 

What are the QAP global options?

To open the Options dialog box, in the Customize window, select Options and one of the 15 sections of the dialog box in the menu bar (or hit Ctrl + O).

In the General tab

  • To enable folders navigation in file dialog boxes (Open, Save As, etc.), check the Change folders in dialog boxes with the main QAP hotkeys.
  • Select your working Language.
  • Choose the colors Theme of QAP Settings and other windows.
  • Enable Windows dark mode support in QAP.
  • Select the Run at Startup option to launch Quick Access Popup automatically when you boot Windows.
  • Select if the QAP Customize window is open when QAP is launched.
  • Set if Startup Tips and Tricks are displayed at QAP startup and the number of days between tips.
  • Display the Startup Tray tip in the Notification zone.
  • Select the Check for updates to be informed when new QAP versions become available.
  • Only if your installed QAP with the Easy Setup installation file, change the location of the Settings Folder (also called “Working Directory”).
  • Select the location of the settings file backup folder.
  • Change the location of the Temporary folder created to store small images, language files and working files required at run time.

In the Customize Window tab

  • Select the font sizes for labels and for the favorites list. Select the font name for the favorite list and for text input fields.
  • Select if the QAP Customize window is open when QAP is launched.
  • Select if the favorites list and search result list display additional columns with last modification date, creation date and, if the database is enabled, last usage date and usage frequency.
  • Remember the Customize window position (else, the window is centered on the screen).
  • On a multi-monitor system, select if the Customize window is displayed on the active monitor.
  • Select if QAP check if an existing favorite has the same location or content as the saved favorite.
  • Automatically add favorites in Main menu at Top of menu or Bottom of menu when added with Add this Folder or Link, Add this Folder or Link Express and Add favorite from the Explorer context menus.
  • On the right side, set the Search scope of the Customize window to all favorites from the Main menu (default) or search only for favorites under the menu currently displayed in the Customize window.
  • Decide if QAP should use the Windows locale settings when searching for favorites (e.g. “é” considered as “e”).
  • Also on the right side, set the Quick Launch window options.
  • Set the size and name of the search results font.
  • When the window under the Quick Launch box is a file manager or dialog box, decide if folders selected in the window change or not the current folder (navigate) in the file manager or dialog box.
  • Include or not the Recent and Frequent menus items in the search results.
  • When searching for favorites, QAP can look at the favorite names only or look for all favorites properties with the Extended Search option.
  • Set the default number of rows displayed in the window (this does not limit the number of items in the results).
  • Set the default order of favorites displayed in the search results.
  • Set the number of Past Queries remembered by QAP and displayed when the search box is empty. Set to zero th disable the Past Queries feature.
  • Change the mouse triggers to open the QAP popup menu (by default, middle mouse button or Windows + W).
  • Choose the keyboard triggers to open the QAP Alternative menu (by default,  Shift + middle mouse button or  Shift + Windows + W).
  • Enable the double-press of the Left or Right Control keys or the double-click of the Right Mouse Button to open the QAP popup menu. Note: Double right-click is supported on any window except on windows excluded in Options, Popup menu and in the QAP Customize window.
  • Display the popup menu near the mouse pointer, in the active window or at a fix position.
  • Display the Drives, Recent Folders and Recent Files menus attached or detached from the popup menu.
  • Enable or disable QAP Explorer Context menus (option available only if you installed QAP using the Easy Setup program).
  • Manage the exclusion or inclusion list of applications where the QAP mouse menu trigger is blocked.
  • Use the Get window info button to identify the window to include or exclude.
  • Display keyboard or mouse shortcuts reminders in menu in short or long format. 
  • On the right side, display hotstrings reminders in menu in short or long format.
  • Select the option to use Display Numeric Menu Shortcuts to launch favorites with your keyboard.
  • Set the number of items in the Recent folders and Recent Files menus.
  • Set the maximum number of path levels in Recent/Frequent menus (exceeding levels will be truncated from the beginning)
  • Set the number of items in the Repeat actions menu.
  • Add the Customize this menu (or group) option at the end of all editable submenus or groups.
  • Add Close to menus created by QAP allowing to dismiss them if clicking elsewhere does not dismiss them.
  • Display or hide menu icons, and choose menu icons size.
  • Override default document icons with your own custom icons.
  • Set replacement icons for the standard QAP icon.
  • Set a custom icon for Link favorites (used instead of the default browser’s icon)

In the Alternative Hotkeys tab

  • Set mouse or keyboard shortcuts, and keyboard modifiers for Alternative menu features.
  • Decide if help notifications are displayed when selecting an Alternative menu.
  • Use the Reset saved modifiers to cancel unsaved changes or the Reset default modifiers to restore the factory settings.

In the File Managers tab

  • Keep the default file manager Windows Explorer or enable support for Directory OpusTotal Commander or Universal file manager support. After you selected your preferred file manager, fill the additional options as shown below for your file manager.
  • When opening the QAP menu by clicking outside of the Preferred File Manager window (or when another window than this file manager is active), set if you QAP opens the folders in a new window (default) or in the current (or last used) Preferred File Manager window.

In the Snippets and Hotstrings tab

In the User Variables tab

In the Database tab

  • Enable or disable the database collecting info from the Recent Items Windows special folder to build the Frequent Folders, Frequent FilesRecent Folders and Recent Files menus and to accelerate the refresh of some dynamic menus.
  • Set the database refresh interval, the number of days considered in the Frequent menus, and maximum size of the database.
  • Flush the content of the database.
  • Show or not a frequency indicator for folders and files in menus and in the Customize window.
  • Select where the QAP menu bar is displayed.
  • Enable automatic refresh of the Shared menus and Live folders menus and set its refresh frequency.
  • Open the menu when hitting the QAP menu trigger on the Windows taskbar.
  • Avoid having the Clipboard menu refreshed if its size exceeds a certain limit.
  • Set the maximum number of items in the Live Folders of your menu.
  • Show the Switch Settings file and Switch to default Settings file menu items under the File menu.
  • Indicate if network drives can sometimes be offline and indicate the network drive letters.

In the Launch Advanced Options tab

  • Run  Quick Access Popup as an administrator.
  • Refresh the Windows Apps list at each QAP startup (if disabled, you can refresh it on demand in the Add Favorite dialog box).
  • Set a replacement for the QAP icon in the Notification zone of the Windows task bar in the “file,index” format, for example C:\Folder\MyFile.exe,1).
  • Select if the QAP keyboard shortcuts are excluded in some application windows. When the shortcuts are not allowed on an application, they are sent to the target window as if QAP was not running.

In the Various Advanced Options tab

  • Change the delay (in milliseconds) inserted at various steps of the process of changing folder in dialog boxes.
  • Set the maximum number of seconds to wait when the Clipboard is busy.
  • Uncheck the Always open Links in new tab or window to navigate a Link favorite in the current browser tab instead of opening the link in a new tab.
  • Enable favorite debugging for placeholders and user variables to display the debug option in Add/Edit Favorites, Basic Settings tab.
  • Keep file name extension when suggesting a name for favorite in Add/Edit Favorites dialog box.
  • Use ASCII codes (ALT+0nnn) when changing folder in Windows Command Line (CMD) or PowerShell for better compatibility for users of international Windows versions (else QAP sends the characters in raw mode).
  • Stop the automatic launch of Quick Clipboard Editor Receiver Lite (this will prevent the use of Clipboard commands).
  • Enable the Shared Menu Catalogue and set in what location Shared menus can easily be added to user’s menu.
  • Change the delays inserted at various steps of Snippets execution (in milliseconds).
  • Set the number of rows in the Manage Icons window (keep zero for the maximum). More info here if the window becomes too large.

How can I make the QAP icon always stay in the Notification Area?

When you run it, Quick Access Popup (QAP) adds an icon in the Notification Area (System Tray) and await your orders. You can click this icon to open the QAP menu.

But icons in the Notification zone have a tendency to fidget and disappear in an obscure sub menu… There is a method to iron the QAP icon in the Notification zone. Follow the instructions for your Windows version:

See also: When do I need to use the QAP icon in the Notifications Area?

Can I use my own documents icons instead of those configured in Windows?

Default document icons shown in QAP menus are normally those configured in Windows. But, starting with QAP v11.5.7, you can override these default icons with your own custom icons. These icons will be displayed in QAP dynamic menus (like Recent Files) and will be suggested as default icons for your new Document favorites.

Each line must start with the type extension (e.g. docx for Microsoft Word), followed by the equal sign “=” and the “file,index” or image file of the default icon. The “file,index” is the path to the file (.ico, .dll or .exe) containing the icon, and the index is the position of the icon in this file, e.g. “C:\Icons\MyFile.dll,1”. You can also use square image files (.png, .bmp, .gif, .jpg) as long as their size is between 16×16 and 64×64 pixels.

You can set the same icon for multiple extensions by joining the extensions using the “+” character. For example:
mp3+wav+acc+aiff=c:\MyIcons\Music.png
xlsx+xlsm=c:\MyIcons\Excel.png

Note: Replacing a custom icon will be immediately reflected in QAP dynamic menus but not in regular favorite documents. To replace the previous custom icon in existing favorites, you can use the Tools, Manage Icons to quickly select the new default icons.

Can I replace the QAP standard menu icons with my own custom icons?

You can replace the standard QAP menu icons with your own custom icons. Open the Options, Menu Icons tab where you can enter a list of custom menu icons replacements. See the list of icon codes below.

In this section of the Options dialog box, you can also set a custom icon for Link favorites that will be used instead of your default browser’s icon.

In the icons replacements text box, enter the QAP menu icon replacements in the text box, one by line. Each line must start with the QAP icon name (e.g. iconFolderLive, as found in the table below), followed by the equal sign “=” and the “file,index” of the replacement icon. The “file,index” is the path to the file containing the icon (.ico, .dll or .exe) and the index is the position of the icon in this file, e.g. “C:\Icons\MyFile.dll,1”. You can also use square image files (.png, .bmp, .gif, .jpg) between 16×16 and 64×64 pixels.

Here is the list of the icons you can replace.

IconPositionQAP icon codeDefault icon
1iconQAP[path]\JLicons.dll,1
2iconAbout[path]\JLicons.dll,2
3iconAddThisFolder[path]\JLicons.dll,3
4iconApplication[path]\JLicons.dll,4
5iconCDROM[path]\JLicons.dll,5
6iconChangeFolder[path]\JLicons.dll,6
7iconClipboard[path]\JLicons.dll,7
8iconClose[path]\JLicons.dll,8
9iconControlPanel[path]\JLicons.dll,9
10iconCurrentFolders[path]\JLicons.dll,10
11iconDesktop[path]\JLicons.dll,11
12iconDocuments[path]\JLicons.dll,12
13iconDonate[path]\JLicons.dll,13
14iconDownloads[path]\JLicons.dll,14
15iconDrives[path]\JLicons.dll,15
16iconEditFavorite[path]\JLicons.dll,16
17iconExit[path]\JLicons.dll,17
18iconFavorites[path]\JLicons.dll,18
19iconFolder[path]\JLicons.dll,19
20iconFonts[path]\JLicons.dll,20
21iconFTP[path]\JLicons.dll,21
22iconGroup[path]\JLicons.dll,22
23iconHelp[path]\JLicons.dll,23
24iconHistory[path]\JLicons.dll,24
25iconHotkeys[path]\JLicons.dll,25
26iconAddFavorite[path]\JLicons.dll,26
27iconMyComputer[path]\JLicons.dll,27
28iconMyMusic[path]\JLicons.dll,28
29iconMyVideo[path]\JLicons.dll,29
30iconNetwork[path]\JLicons.dll,30
31iconNetworkNeighborhood[path]\JLicons.dll,31
32iconNoContent[path]\JLicons.dll,32
33iconOptions[path]\JLicons.dll,33
34iconPictures[path]\JLicons.dll,34
35iconRAMDisk[path]\JLicons.dll,35
36iconRecentFolders[path]\JLicons.dll,36
37iconRecycleBin[path]\JLicons.dll,37
38iconReload[path]\JLicons.dll,38
39iconRemovable[path]\JLicons.dll,39
40iconSettings[path]\JLicons.dll,40
41iconSpecialFolders[path]\JLicons.dll,41
42iconSubmenu[path]\JLicons.dll,42
43iconSwitch[path]\JLicons.dll,43
44iconTemplates[path]\JLicons.dll,44
45iconTemporary[path]\JLicons.dll,45
46iconTextDocument[path]\JLicons.dll,46
47iconUnknown[path]\JLicons.dll,47
48iconWinver[path]\JLicons.dll,48
49iconFolderLive[path]\JLicons.dll,49
50iconIcons[path]\JLicons.dll,50
51iconPaste[path]\JLicons.dll,51
52iconPasteSpecial[path]\JLicons.dll,52
53iconNoIcon[path]\JLicons.dll,53
54iconUAClogo[path]\JLicons.dll,54
55iconQAPadmin[path]\JLicons.dll,55
56iconQAPadminBeta[path]\JLicons.dll,56
57iconQAPadminDev[path]\JLicons.dll,57
58iconQAPbeta[path]\JLicons.dll,58
59iconQAPdev[path]\JLicons.dll,59
60iconQAPloading[path]\JLicons.dll,60
61iconFolderLiveOpened[path]\JLicons.dll,61
62iconSortAlphaAsc[path]\JLicons.dll,62
63iconSortAlphaDesc[path]\JLicons.dll,63
64iconSortNumAsc[path]\JLicons.dll,64
65iconSortNumDesc[path]\JLicons.dll,65
66iconQAC[path]\JLicons.dll,66
67iconQACadmin[path]\JLicons.dll,67
68iconQACadminBeta[path]\JLicons.dll,68
69iconQACadminDev[path]\JLicons.dll,69
70iconQACbeta[path]\JLicons.dll,70
71iconQACdev[path]\JLicons.dll,71
72iconQuickLaunch[path]\JLicons.dll,72
73iconWatch[path]\JLicons.dll,73
74iconClipboardCheck[path]\JLicons.dll,74
75iconClipboardList[path]\JLicons.dll,75
76iconProcessCircle[path]\JLicons.dll,76
77iconSystemInfo[path]\JLicons.dll,77
78iconChecked[path]\JLicons.dll,78
79iconMagnify[path]\JLicons.dll,79
80iconNotebook[path]\JLicons.dll,80

Icons by: Icons8

Can I schedule automatic menu refresh for Live folders and Shared menus?

Yes. In Options, Menus Advanced Options tab, check the Enable Scheduled QAP Menu Refresh option. This options refreshes the Live Folders menu and the Shared menus. Set the interval between each refresh (in seconds). Keep in mind that the refresh momentarily disables the popup menu. Minimum interval is 30 seconds and recommended interval is 300 seconds (5 minutes) or more.

The check box Beep before and after refresh enables a short beep that is played at the beginning and the end of the refresh interruption. This helps decide at what frequency schedule the refresh. Do not forget to turn this off when you are set.

 

Where is the QAP settings folder (also known as “working directory”)?

The Settings Folder (called “Working Directory” in v9 and before) is the folder where the QAP settings files (QuickAccessPopup.ini and QAP_Frequent.DB) are saved and updated.

Open the Settings folder

Normally, you would not need to open this folder. But if you want to backup its content or to move it to a new computer, you can open this folder by selecting File, Open QAP Settings Folder in the Customize window menu bar (under QAP v9 or earlier, right-click the QAP icon in the Notification zone and select Open QAP working directory).

Location of the Settings Folder if you installed QAP with Easy Setup installation (EXE file)

If you installed QAP using the “one-step installation” procedure using the EXE setup file, the Settings Folder is:

  • for new v10 installations: [user folder]\Documents\Quick Access Popup
    (for example, C:\Users\Jean\Documents\Quick Access Popup)
  • if you first installed QAP with v9 or earlier, the settings folder is
    [user folder]\AppData\Roaming\Quick Access Popup
    (for example, C:\Users\Jean\AppData\Roaming\Quick Access Popup).
Location of the Settings Folder if you are running in Portable mode (ZIP file)

If you preferred the portable installation, by default the Settings Folder is where the QuickAccessPopup.exe program is running.

See also: Can I change the location of my QAP settings folder?

Can I change the location of my QAP settings folder?

Yes, with QAP v10 (or more recent), if you installed QAP with the Easy Setup file. See below if you choose to install with the Portable ZIP file. See also: Where is the QAP settings folder (also known as “working directory”)?

You can change the Settings folder in Options, General tab. Select the new folder in the Settings Folder text box and click Save.

When saving the new location, QAP asks why you want to change the Settings Folder location.

  • If you want to copy your current settings to a new location and run QAP from this location in the future, select Copy.
  • If you want to use the setting already found in this new location when QAP will be restarted, click New. If this location does not contain QAP settings (namely, the quickaccesspopup.ini file), new settings files will be created in this folder.

In both cases, the settings files in the original (old) folder are not deleted. Remove them at your convenience after you completed the operation at your satisfaction.

Location of the Settings Folder if you are running in Portable mode (ZIP file)

If you preferred the portable installation, by default the Settings Folder is where the QuickAccessPopup.exe program is running.

In this type of installation, you can set a different Settings Folder by editing the QAP shortcut in the Startup folder (or create your own shortcut) and set the QAP Settings Folder directory in the Start in: field of the shortcut.

Alternatively, you could also set the Settings Folder using a the “/Working:” command-line parameter. For example:

C:\MyFolder\QuickAccessPopup.exe /Working:C:\MySettings

The “/Working:” parameter can be set at the command line, in a Windows file shortcut or in the current user registry Run key for Quick Access Popup. This parameter has precedence on the Settings Folder value in the Options, General tab. For example:

“C:\Program Files\Quick Access Popup\QuickAccessPopup.exe” “/Working:C:\Users\UserName\Documents\My Folder”

Use quotes when a file path includes spaces.

Can I block the QAP menu trigger (Middle Mouse Button) if it interfere with one of my other apps?

Yes. There may be some applications where the user does not want the QAP menu mouse trigger (by default, Middle Mouse Button) to interfere with the app’s normal behavior. QAP allows to block the QAP mouse menu based on the window title, window class or process name.

But, before considering blocking hotkeys, you could first see if another hotkey would best fit your needs. If yes, use the Options window, tab Popup Hotkeys to select different triggers for the QAP menu.

If you prefer the exclusion approach, open the Popup Menu tab in the Options. In the Mouse trigger Blacklist or Whitelist text zone, select the exclusion (Blacklist) or inclusion (Whitelist) approach and enter any part of the window title of the application to exclude or include (the window title is what appears in the top horizontal bar of the window). You can enter multiple exclusions, one per line.

 

For example, to exclude Google Chrome and Microsoft Word applications, select Blacklist and enter the following two lines in the exclusion list:

Google Chrome
Microsoft Word

Click Save and try the to open the menu again in these windows. The menu won’t show up. The QAP hotkey is disabled and the Middle Mouse Button click is sent to the target window as if QAP was not running.

Excluding dialog boxes

By default, QAP will only block the mouse hotkey in the app’s main window. You can also disable the mouse hotkey in app’s dialog boxes by adding the prefix * (asterisk) to the title or the class name, for example:

*3D Studio

In this example, the mouse hotkey will be blocked in both the 3D Studio Max main window and in its dialog boxes.

To be more specific

Using this technique, there may be situation where a window title in another app could include one of the exclusion strings you entered. For example, if you save a file in Notepad under the name “My Microsoft Word tips and tricks.txt”, this window would be excluded because it includes the string “Microsoft Word”. But you can be more specific with this:

- Microsoft Word

Adding the dash and space at the beginning of the string will exclude Word windows because the app name in the Word’s title bar is always preceded by the document name and a dash between spaces.

To be a bit more technical

Another way to be more specific is to enter part of the app’s “window class name”. For example, Word’s windows class name is “OpusApp” and Chrome’ windows class name is “Chrome_WidgetWin”. So, these two exclusion lines could be:

Chrome_WidgetWin
OpusApp

You can also exclude an application based on its process name. This is a solution for applications having variable class names. Usually, the process name is the file name of the application’s executable file, for example the Chrome process name is “chrome.exe” and the Word process name is “winword.exe”. So, the exclusions list could also be:

winword.exe
chrome.exe

How can I find a window class name, process name or a window title if the app has no title bar?

To identify the window you want to exclude, use the Get window info button at the bottom of the Exclusions list in the Options dialog box. It will prompt you to click in the target window with the QAP menu hotkey (Middle Mouse Button) and will copy the window title, class name and process name in your Clipboard. Paste this info in the exclusion list and edit it to remove unnecessary parts as described above.

 

There are other tools to gather more info about windows. I recommend this freeware utility: WinLister by NirSoft.

To block other QAP keyboard shortcuts, see also: Can I block the QAP keyboard shortcuts if they interfere with one of my apps?

Can I block the QAP keyboard shortcuts if they interfere with one of my apps?

Yes. There may be some applications where the user does not want the QAP favorites keyboard hotkeys to interfere with the app’s normal behavior. QAP allows to block its hotkeys based on other app’s the window title, window class or process name.

Under Options, Launch Advanced Options, you can list the applications where QAP will disable (Block) all its favorites keyboard shortcuts: favorites shortcuts and Alternative menus features shortcuts. When the shortcuts are not allowed on an application, they are sent to the target window as if QAP was not running.

Note 1: This option does not affect the Main and Alternative menus keyboard shortcuts and the Main menu mouse trigger (see this page to block the Main menu mouse trigger).

Note 2: You can also do the opposite and select the only applications where the keyboard shortcuts will be allowed by clicking the Approved radio button. In the following explanation, we assume that you kept the Blocked option.

To add an application to the list, enter any part of the its window title. You can enter multiple applications, one per line. In the example above, QAP hotkeys will be inactive in any window including the name Resolve. You can also add applications by their class name or process name (EXE file name). In the example, the application Photoshop Elements having the executable file PhotoshopElementsEditor.exe will run with QAP hotkeys disabled.

See also Can I block the QAP menu trigger (Middle Mouse Button) if it interfere with one of my other apps?

Does QAP support Windows dark mode?

Yes. You can enable QAP dark mode support in Options, General. When this option is enabled and Windows colors personalization for applications is set to Dark, QAP menus will be displayed with white text on black background. The QAP Customize windows will also be displayed with dark background after you restart QAP. At this time, not all QAP dialog boxes support dark mode.

Note 1: When using dark mode, the QAP Theme (also in Options, General) is automatically set to Windows.

Note 2: Known issue… Menu having multiple columns (using the column break in your QAP menu), do not obey the command that sets the dark mode. See this example. This is a limitation of Windows that QAP cannot do anything about.

Can I change the colors of the Customize window or the popup menu using themes?

You can choose Quick Access Popup colors for Customize window and other dialog boxes. You can also change the popup menu background color (see About menu colors, below).

Note: QAP Theme colors are not supported when using the Windows Dark Mode. See: Does QAP support Windows dark mode?

Colors are managed using “themes”. The available themes are listed in the Options dialog box, General tab. Themes can be edited or added in the QAP settings file. Here are the instructions if you want to edit or add themes.

1) Open the quickaccesspopup.ini file

See How can I edit the file QuickAccessPopup.ini?

2) Add the code for the new theme

At the end of the .ini file, add your theme following this syntax:

[Gui-New Theme]
WindowColor=E0E0E0
TextColor=000000
ListviewBackground=FFFFFF
ListviewText=000000
MenuBackgroundColor=FFFFFF

Replace “New Theme” with a name of your choice (use only letters, numbers and spaces – no special characters) and color codes with your own colors. You can use this color picker to select your colors.

3) Under the [Global] ini file section, update the list of themes offered in the Options window:

AvailableThemes=Grey|Yellow|Light Blue|Light Red|Light Green|New Theme

Again, replace “New Theme” with the name of the new theme (exact same name as in step 2).

4) Choose your new theme

Save the QuickAccessPopup.ini file and restart Quick Access Popup. Select your theme in the Options dialog box, General tab. That’s it!

About menu colors
Color management capabilities are limited by QAP’s development framework. Especially for menu background color (the MenuBackgroundColor value above), note that the color of menu text cannot be changed. Since the text must stay black, dark color background should be avoided for menus. Also, the background color behind menu icons cannot be changed.

Why these limitations? QAP could offer more flexibility. But this would be done at the cost of completely redrawing menus instead of using the standard basic Windows command to build menus. This is not in my plan to do it.

About Windows themes
QAP themes has been designed with the “normal” Windows theme (as selected in Windows SettingsPersonalisationThemes). QAP themes may not work well with some Windows themes. If you use Windows themes, you should choose the QAP theme named Windows that will not interfere with Windows themes

How can I control how the Frequent Items database works?

Setting up the Frequent Items database

The first time QAP is launched, it installs the SQLite files required to collect data about your Windows and QAP usage. These files are saved in the same folder where is installed the Quick Access Popup executable file.

A database named QAP_Frequent.DB is then created in the QAP settings folder. Periodically (by default every minute), QAP stores in this database the Recent Items collected from Windows since the last update. This very light background process is unnoticeable from a performance point of view.

QAP also logs in this database your QAP menu usage. It allows to track recent folders open in QAP that would not be added to the Windows Recent Items. With QAP v11 (or more recent), the database is also used to suggest items in the Add Multiple Favorite command.

For more curious and technical users wishing to browse this database, I recommend the use of the free app SQLite Browser (this tool is not required for normal users).

Configuring the Frequent Items database

You can set the parameters of the Frequent Items database in Options. Under the Database tab, you can enable or disable the database. If is is disabled, the Frequent Folders and Frequent Files menus will be empty (you can remove them in the Customize window).

 

When enabled, the database is refreshed by default every 60 seconds. You can change this under Collection and refresh interval (seconds).

You can also set the period considered when building the Frequent menus. For example, if you would like to see your most used items in the last week, set the Number of days to take into account in Frequent Items menus to 7. By default, the period is of 30 days. You can also increase it if you prefer to see your long term most used items.

By default the database size is limited to 3 MB. This should be enough for 30 days of normal use of QAP. But if you are an intensive user or if you wish to keep a longer period, increase this size. There is no limit to the number of days or size of the database. When the size limit is exceeded, oldest items are removed until the maximal size is respected.

If you would like to see the ranking of items in the Frequent menus, enable the Show frequency index in “Customize” window and menus. This will show that value for each item in the menus and also in the Customize window for item found in the database.

Finally, if, for privacy or any other reason, you want to delete the database content, click the Flush Frequent Items from database button. This will delete all items from the database. After you restart QAP, the Frequent and Recent items menus will be empty. If you keep the database enabled, these menus will be repopulated as new contents from the Windows Recent Items will be added, starting at the time of the last collection.

If files in the database goes offline

If you sometimes have offline network files in your Recent Items Windows folder (for example, if your portable computer is attached to network drives at work but not when you are outside office), see the recommendations about network drives.

What if the Recent menus remains empty?

The Recent Folders and Recent Files menus are populated from the Windows Recent Items folder. Check if you have recent folders and files in this system folder:

C:\Users\Username\AppData\Roaming\Microsoft\Windows\Recent
(replace “Username” with your own user name)
or enter
%APPDATA%\Microsoft\Windows\Recent Items

If this folder is empty (or outdated), enable it in Window Settings. See instructions on one of these pages: for Windows 10 or Windows 7.

What command-line parameters are available for the QAP executable file?

There are three supported arguments:

 

How does QAP work on multi-monitor systems?

When QAP detects that it is running on a dual or multi-monitor system, it adjusts it behavior in two ways.

Open new Windows Explorer windows on active monitor

(This post applies to QAP v9.3.2 and more recent.)

When the option On a multi-monitor system, always open the Explorer window on the active monitor is checked and QAP detects that it is running on a dual or multi-monitor system, it will open the new Explorer windows at the center of the active monitor.

QAP determines which monitor is the active monitor in one of the following ways:

  • if the QAP menu was open using the mouse trigger (for example, the default Middle Mouse Button), it will open the Explorer window on the monitor where the mouse pointer was positioned when the menu was open;
  • if the menu was open using the keyboard trigger (by default Windows + W) or if the favorite was launched using a keyboard shortcut, QAP will open the Explorer window on the monitor where is located the currently active application window.

Note for Directory Opus users: DOpus offers an option that will make new listers to be opened on the active monitor. Search for Default Lister Positioning in the DOpus options window.

Settings windows

(This post applies to QAP v9.3.1 and more recent.)

If the option Remember Settings window position is checked, QAP will reopen its Settings window at the last position you moved it in the current or last session. However, it the screen configuration has changed (you added/removed a monitor, changed a monitor resolution or selected a different primary monitor), QAP will reset it Settings window position to the center of the primary monitor. This will prevent the Settings window to be restored on a monitor or screen region that is no longer visible.

Also, all secondary settings windows (Options, Select favorite type, Add/Edit/Copy/Move Favorite, Add Shared menu from catalogue, Manage Hotkeys, Manage Icons, About, Donate and Help) are now always positioned on top of the Settings window. In addition, QAP will remember the width of the Add/Edit/Copy/Move Favorite windows in order to allow very long Parent menu names to be fully displayed.

 

Can I backup, import or export my favorites and options?

(2023-08-29 – this page has been updated to v11.6.2.3 )

First, about backups, QAP is automatically copying daily backups of your main settings file (QuickAccessPopup.ini) and keep the backups for the last 5 days in the backup folder selected in the Options, General tab. You can retrieve a backup file by putting aside the current QuickAccessPopup.ini file and rename the backup file from QuickAccessPopup-backup-YYMMDD.ini to QuickAccessPopup.ini.

If you need more flexibility, the QAP features Export Options and Favorites, Import Options and Import Favorites can be uses for two reasons:

  • exchange settings (favorites and options) between different PCs or different users;
  • create a backup of your favorites and global options in a file that you can save where you want.

To open the Import and Export dialog boxes, select one of the entries in the File menu in the Customize window menu bar. You can also add these features to your QAP menu by adding a QAP Feature found under the QAP Management section.

Exporting Options and Favorites

  1. Choose the Destination file that will be created (if it does not exist) to store your exported data. The last destination file is remembered and displayed as default file. The path can include the %A_NowUTC% and %A_NowUTC% variables, environment variables, QAP user variables and placeholders. For example, the file name my-export-%A_Now%.ini would be converted to my-export-20230829112529.ini.
  2. Choose the settings category to export: global options, hotkeys, alternative menu hotkeys and modifiers, themes and favorites.
  3. Click the Export button.
  4. You will be alerted if settings exist in the destination file and asked if you want to overwrite them or not. For favorites, you will be asked if you wish to overwrite or append the imported favorites. A report will summarize the completed actions.

Importing Options

  1. Choose the Source file containing the data to import. The last source file is remembered and displayed as default file. The path can include environment variables, QAP user variables and placeholders.
  2. Choose the settings category to import: global options, hotkeys, alternative menu hotkeys and modifiers, and themes.
  3. Click the Import button.
  4. You will be asked if you want to overwrite existing settings or not. A report will summarize the completed actions.

Importing Favorites

Favorites can be imported in the Add Multiple Favorites dialog box available under Edit, Add Multiple Favorites. This dialog box offers many source options. To import favorites from a QAP settings file, select QAP Settings File (tree view). You can also access this dialog box with this option selected by choosig the menu File, Import Favorites. More info on adding multiple favorites, see: Can I add multiple favorites in one click?

Tips

  • To import settings, the source file content must comply with QuickAccessPopup.ini structure. More info about ini file anatomy here: What is the structure of QAP settings (ini) file?.
  • Note: before QAP v10.3.2, the import/export features had an undocumented size limitation. This was an issue if the size of the [Favorites] section of you settings file was larger than 65,532 characters. This is why, for safety, it is mandatory to update QAP to v10.3.2 (or more recent) before using the Export command.

On two PCs with a cloud drive (like Dropbox), can I save my QAP settings on this cloud drive?

No, this is not recommended. But there is a better solution.

If you save your settings file (quickaccesspopup.ini) on a cloud drive, you could face synchronisation issues. Let’s figure this scenario: 1) you edit your settings on system A but do not save them yet (leaving the Settings window open), 2) then edit your settings on the computer B and save them; 3) finally, back to computer A, you find the Settings window open and Save and Close it. Doing that, you overwrite the changes done on system B and, at best, your cloud drive will show two conflicting versions of your settings file. And there may be other scenarios like this one.

It is a better option to have your settings saved on a different folder for each PC and use a Shared menu of type Personal. Then, QAP will monitor changes on the two (or more) computers and will alert you if you have changes on one computer that are not saved on another system.

You can insert your shared menu at the top level of your QAP menu to access it easily. You can also assign a specific keyboard shortcut or mouse button to this menu. Finally, see how user variables and system variables can help you if your cloud drive and system folders are saved on different locations on your systems.

More info on shared menus here: Can a submenu be shared on different PCs or by different users?

Can I move my configuration from one PC to another?

Yes. First install QAP on the new PC and copy/replace the newly created quickaccesspopup.ini file with the one copied from your previous PC. The quickaccesspopup.ini file can be found in the QAP working directory.

All your favorites, hotkeys and preferences from the Options will be preserved. Of course, only favorite folders, documents or applications with the same location on the new PC or having portable locations will work. Also, most Special folders favorites will work as-is on the new PC. For Special folder favorites that do not work, delete them and add them again using the Add Favorite button.

However, if you are moving from a portable installation to an “easy setup” installation (or vice-versa), you should read this: Can I change from/to “easy setup” and “portable installation” without loosing my favorites?

 

Can I change from/to “easy setup” and “portable installation” without loosing my favorites?

You can switch from Portable to Easy setup installation or vice-versa without loosing your favorites. But it is recommended to follow this short procedure.

1 a) Switching from Portable to Easy Setup installation

  1. Copy your latest settings file from your current QAP working directory to your Desktop (or any other location of your choice). Your working directory is where your portable QAP is installed.
  2. Reinstall QAP following Easy Setup wizard steps.
  3. At the end of the installation procedure, QAP is launched with the default configuration for an Easy Setup installation. Continue with steps under 2) Importing the favorites from your previous installation below.

1 b) Switching from Easy Setup to Portable installation

  1. Copy your latest settings file from your current QAP working directory to your Desktop (or any other location of your choice). For QAP before v10, your working directory is under the User directory (for example, C:\Users\Jean\AppData\Roaming\Quick Access Popup). For QAP v10 (or more recent), the working directory is shown in the Options, General tab under Settings Folder.
  2. Unzip the QAP portable ZIP file in a new (empty) folder following these instructions. Do not install it in a system-protected folders like those under C:\Program Files or C:\. This could prevent QAP from saving your configuration.
  3. Launch QAP from this folder (choose the QuickAccessPopup-32-bit.exe or QuickAccessPopup-64-bit.exe version depending on your system).
  4. QAP is launched with default configuration for a Portable installation. Continue with steps under 2) Importing the favorites from your previous installation below.

2) Importing the favorites from your previous installation

  1. In the Customize window, remove all the favorites in the new file (select all favorites and click the Remove button). These favorites will be replaced with the favorites from your backup in the next step.
  2. Using For QAP v11.1 or more recent, open the Favorites, Add Multiple Favorites, select the source QAP Settings File (tree view) and click Continue.
  3. In the Add Multiple Favorites dialog box, keep the Main menu as destination menu and click the Browse button to select the backup of your previous settings file on your Desktop.
  4. Click the Select All checkbox to select all favorites and click the Add button to import the selected favorites and submenus in the your new Main menu.

Differences between Easy Setup and Portable settings

There are very little differences in the way QAP works whatever you select the Setup mode or the Portable mode. In general, setting up QAP in Setup mode is simpler and answers most needs. The Portable mode give user more control and allows to use QAP on a machine having to copy files on it or change the hosts system configuration.

The QAP files are installed…

  • Setup mode: … using the setup program who is copying the QAP files under the C:\Programs File\Quick Access Popup\ folder, the QAP icons files in C:\ProgramData\JeanLalonde\JLicons.dll and the setting and database files in C:\Users\YourUserName\AppData\Quick Access Popup\ (for QAP pre-v10) or in My Documents\Quick Access Popup (for QAP v10).
  • Portable mode: … by the user who is unzipping the QAP zip file to the folder of his choice, including the icons, settings and database files.

When QAP is running…

  • Setup mode: … its working directory is C:\Users\YourUserName\AppData\Quick Access Popup\ (for QAP pre-v10) or in My Documents\Quick Access Popup (for QAP v10). Temporary files are saved under this folder unless user selected another folder in Options.
  • Portable mode: … its working directory is the folder where QAP is running. Temporary files are saved under this folder unless user selected another folder in Options.

The QAP is uninstalled and its files are removed…

  • Setup mode: … using the standard uninstall command in Windows Control Panel or in Quick Access Popup menu under Start menu; this command remove all files under Programs but keep the settings files in its working directory.
  • Portable mode: … by the user who must manually delete the folder created to run QAP, taking care of keeping a copy of the settings file quickaccesspopup.ini if necessary.

The QAP shortcut in the Startup folder…

  • Setup mode: … is created automatically for you if you use for pre-v10 (QAP v10 or more recent uses an entry in the Windows registry to run QAP at startup).
  • Portable mode: … must be created by the user by selecting the checkbox in Options.
  • See: What are the QAP global options?

The QAP entries in the Windows Explorer context menu…

The Check for update command…

The Usage Monitoring module (starting in v9.2)…

  • Setup mode: … is set ON by default.
  • Portable mode: … is set OFF by default and can be enabled in Options.

Can I set the QAP settings file location from the command line or a file shortcut?

You can set the settings file location from command-line using the parameter “/Settings:”, for example:

"C:\Program Files\Quick Access Popup\QuickAccessPopup.exe" "/Settings:C:\Users\UserName\Documents\Quick Access Popup\My Settings.ini"

Use separate double-quotes for application file and for parameter if the location includes one or more spaces.

If you create a file shortcut (.lnk file) for QAP, insert the command in the Target field.

The Settings file location can include environment variable (like %userprofile%) and supports relative paths based on the QAP working directory. See Can I use system environment variables in favorite paths? and Can I use relative paths in favorite settings?

Note 1: If you only need to change the QAP settings file temporarily, see: Can I load QAP with an alternative settings file?

Note 2: Changing the QAP settings file location does not change the QAP Settings Folder (aka Working Directory). Other settings files (like QAP_Frequent.DB) will still be read or updated in the active Settings folder. See how to change the Settings Folder if you want this change to be persistent for your future use of QAP.

Can I load QAP with an alternative settings file?

Yes, you can load an alternative settings (.ini) file. However, this should be done only for specific or temporary needs. Starting with QAP v11.0.6, you have to enable the option Show or not the advanced Settings file menu items under the “File” menu under Advanced Menu Options to see the File, Switch Settings file menu in the menu bar. In the dialog box, choose the alternative file and confirm that you want to reload QAP with these new settings. When the new settings file is loaded, the Edit QuickAccessPopup.ini entry in the system menu is changed with the name of the alternative file.

If you wish to revert to the default settings file QuickAccessPopup.ini, in the menu bar, select File, Switch to default settings file.

If you prefer to control QAP startup with your own Windows file shortcut (.lnk file), see: Can I set the QAP settings file location from the command line or file shortcut?

If you installed QAP in Portable mode (with the .ZIP file) and enabled the Run at Startup option, the alternative settings file name is saved in the Startup shortcut used to launch QAP at Windows startup. When you reload Windows, QAP is loaded with the alternative settings. However, if you load QAP using the Start menu or command line, the default settings file QuickAccessPopup.ini is loaded.

If you installed QAP in Easy Setup mode (with the .EXE file), QAP is always launched with the default settings file.

Note: Loading an alternative QAP settings file location does not change the QAP Settings Folder (aka Working Directory). Other settings files (like QAP_Frequent.DB) will still be read or updated in the active Settings folder. See how to change the Settings Folder if you want this change to be persistent for your future use of QAP.

How can I edit the file QuickAccessPopup.ini?

Normally, the QAP settings can be modified using the QAP Settings and Options windows and you don’t need to edit the .ini file containing your favorites and your preferred configuration.

For some specific operation, you may need to edit this file named QuickAccessPopup.ini that can be found in the QAP working directory. You can open this file using any text editor. But the easiest way to open the settings file is to use select the File, Edit QuickAccessPopup.ini in the QAP menu bar.

The file will be open in your default text editor for ini files (Notepad if you did not change it in Windows).

For more information about the settings file, see What is the structure of QAP settings (ini) file? and What are the values in the QAP settings (ini) file?.

 

What is the structure of QAP settings (ini) file?

The following information is for advanced users who need to change the QAP settings by editing the QuickAccessPopup.ini file saved in the QAP working directory. See also How can I edit the file QuickAccessPopup.ini?

The ini file format described in this page also applies to shared menus, exported settings file and to import settings files. See also What are the values in the QAP settings (ini) file? for detailed reference info.

Regular users should not be required to edit these files except in rare situations described in the FAQ or in the Support page.

[Global] Section

This section contains settings managed in the Options dialog box or managed internally by QAP.

[Global]
LanguageCode=EN
NavigateOrLaunchHotkeyMouse=MButton
NavigateOrLaunchHotkeyKeyboard=#w
PowerHotkeyMouseDefault=+MButton
PowerHotkeyKeyboardDefault=+#A
Check4Update=1
DisplayIcons=1
DisplayMenuShortcuts=0
IconSize=32
...

See the description of these QuickAccessPopup.ini variables.

See also the special [Global] values for Shared menus below.

[Favorites] Section

This section contains the favorites found in your QAP menu. It starts with the first item in your main menu (“Favorite1=…”) and ends with a line with a favorite of type “Z” (“Favorite7=Z” in the following example). When a submenu is added to your menu, it starts with a line of type “Menu” and ends with a line of type “Z” (“Favorite5=Z” below) and it continues with the content of the previous menu. Submenus can be nested at will. FavoriteN numbers must be consecutive. Menu loading stops at first missing N.

For example:

[Favorites]
Favorite1=Folder|Name of folder in main menu|...
Favorite2=Document|Name of document in main menu|...
Favorite3=Menu|Submenu name|...
Favorite4=Folder|Name of folder in submenu|...
Favorite5=Z
Favorite6=Folder|Name of next folder in main menu|...
Favorite7=Z

Format of each line:

[Favorites]
FavoriteN=FavoriteType|FavoriteName|FavoriteLocation|FavoriteIconResource|FavoriteArguments|FavoriteAppWorkingDir|FavoriteWindowPosition|FavoriteLaunchWith|FavoriteLoginName|FavoritePassword|FavoriteGroupSettings

FavoriteN= where N is a number starting at 1. One favorite line contains infos delimited by | (pipe), real pipes in values being replaced with the sequence “Сþ€” in ini file for all values except fields 1, 7 and 8.

Favorite fields order and names:
1 FavoriteType
2 FavoriteName
3 FavoriteLocation
4 FavoriteIconResource
5 FavoriteArguments
6 FavoriteAppWorkingDir*
7 FavoriteWindowPosition (Boolean,MinMax,Left,Top,Width,Height,Delay,RestoreSide/Monitor (comma delimited)
8 FavoriteLaunchWith
9 FavoriteLoginName
10 FavoritePassword
11 FavoriteGroupSettings

 

* 6 FavoriteAppWorkingDir: for “TC Hotlist”, target path

Example

[Favorites]
Favorite1=Folder|Windows|C:Windows|C:WindowsSystem32shell32.dll,298|||||||
Favorite2=Document|My Notes|C:Docsnotes.txt||||||||

[Favorites-backup] section

Each time the favorites are saved using QAP, a [Favorites-backup] section is created with the current content of the [Favorites] section. Be careful to edit the current [Favorites] section and not its backup.

Themes settings

[Gui-Grey] and other sections starting with “Gui-” are theme descriptions. More info on themes in this page: Can I change the colors of the Customize window or the popup menu using themes?.

[AlternativeMenuHotkeys] section

This section contains the hotkey (shortcuts) settings managed in the Alternative Menu Hotkeys tab of the Options dialog box.

[AlternativeMenuModifiers] section

This section contains the modifiers that can be used in the QAP menu to call Alterative menu features, set in the Alternative Menu Hotkeys tab of the Options dialog box.

[LocationHotkeys] section (deprecated after v8.7.1.1)

Up to version v8.7.1.1, this section contained the favorites hotkey (shortcuts) settings managed in Change hotkey dialog box. You can open this dialog box in the Shortcut section of the Menu Options tab in the Add/Edit Favorite dialog box or in the the Manage Hotkeys dialog box.

From v8.7.1.93, shortcuts are saved in the [Favorites] section as parameter #20 (see object model).

Import and Export ini files

The files created when your export settings comply to the format described in this page. Files imported must also comply with this format. However, they could include any or all of these settings sections: Favorites, Hotkeys, Alternative menu hotkeys, Alternative menu modifiers, Global settings and Themes. More info on import/export commands here: Can I backup, import or export my favorites and settings?

Shared menus

Shared menu are saved in ini files complying to the format described in this page. But they contain only a [Favorites] section as described earlier and a special [Global] section with shared menu specific variables. More information about shared menu settings file: What is the content of a shared menus settings file (for advanced users)?

What are the values in the QAP settings (ini) file?

Normally, the QAP settings can be modified using the QAP Customize and Options windows and you don’t need to edit the .ini file containing your favorites and your preferred configuration. But if, for some specific operation, you need to edit this file named QuickAccessPopup.ini, see How can I edit the file QuickAccessPopup.ini? in the FAQ. See also What is the structure of QAP settings (ini) file? for an explanation of the settings files organization.

The following list describe all variables found in the QuickAccessPopup.ini file with a reference to the FAQ page about the related feature.

This info is reserved to QAP advanced users who know what they do and do it at their own risk. QAP does not always validate the info entered directly in the settings file before using it, which could lead to unpredictable results. Handle with care…
 

NameDefaultDescriptionLien
ActiveFileManager1File manager used when opening a folder in a new window
1: WindowsExplorer
2: DirectoryOpus
3: TotalCommander
4: QAPconnect (about 50 other file managers)
Help
AddAutoAtTop1 (true)Add new favorite at the top (if true) or bottom (if false) when adding with commands "Add This Folder", "Add This Folder Express" or with QAP Explorer Context menus.Help
AddCloseToDynamicMenus1 (true)Add a close menu allowing to dismiss the QAP menu. This menu entry can be turned off if user prefer to dismiss the menu by click elsewhere (but this is known as not working 100% of times)Help
AlternativeHotkeyKeyboard+#WKeyboard hotkey to open the QAP Alternative menu ("+" stands for Shift and "#" for Windows)Help
AlternativeHotkeyMouse+MButtonMouse button to open the QAP Alternative menu ("+" stands for Shift and "MButton" for middle mouse button)Help
AlternativeTrayIcon(none)File path of an image to use as a replacement for standard QAP icon in the Notification zoneHelp
AvailableThemesWindows|Grey|Light Blue|Light Green|Light Red|YellowList of themes described in this settings fileHelp
BackupFolder(working directory)Location of the backups of quickaccesspopup.ini file (also supported in Shared menus with QAP v10+)Help
ChangeFolderInDialog0 (false)Allow QAP to change folder in file dialog boxesHelp
ChangeFolderInDialogAlertRead0 (false)Confirm that user read the info about risk of trying to change folder in a "non-file" dialog boxHelp
Check4Update0 (false, for portable) / 1 (true, for setup)Allow QAP to check on QAP website if a new version is availableHelp
DefaultMenuBuilt0 (false)Informs QAP that the default menu "My QAP Esssentials" and "My Special Folders" were built (normally at first QAP execution)Help
DiagMode0 (false)Enable diagnostic mode for debugging purpose (collecting data in the file QuickAccessPopup-DIAG.txt while executing specific functions)
DirectoryOpusNewTabOrWindow(none)Parameter sent to Directory Opus when opening a folder in a new window or tab ("NEW" or "NEWTAB")Help
DirectoryOpusPath(none)Path to the executable file of the file manager Directory OpusHelp
DirectoryOpusUseTabs1 (true)Instructs QAP to open folders in a new tab (if true) or in a new instance of Directory Opus (if false)Help
DisplayIcons1 (true)Instructs QAP to display menu iconsHelp
DisplayMenuShortcuts0 (false)Instructs QAP to display menu shortcuts (numbers or letters allowing to select menu item by hitting its number or letter)Help
DisplayTrayTip1 (true)Instructs QAP to display the popup in the Notification zone when menu is ready after startupHelp
DynamicMenusRefreshRate10000Number of milliseconds between background refresh of dynamic menus (not used at this time)Help
ExclusionMouseList(none)List of applications or windows where the QAP main menu mouse trigger will be ignored; part of the window title or window class name, separated by vertical bar (|); if prefixed by "*", the exclusion also apply to app's dialog boxesHelp
ExplorerContextMenus1Indicate if Explorer context menu were enabled by setup program or by QAP in Options, or disabled in QAP Options. Chaging this value in setings file have no effect and should be avoided.Help
ExternalMenusCataloguePath(none)Path to the catalogue root on a shared driveHelp
ExternalMenusCataloguePathReadOnly0 (false)When set to "1" prevent user from enabling/disabling the catalogue or changing its path in the Options dialog boxHelp
HotkeyReminders3Display hotkey reminders in menu in short or long format
1: Do not display
2: Display abbreviated names
3: Display full names
Help
IconSize32Size of icons in QAP menu, in pixelsHelp
IconsManageRows(none)Number of rows to display in the Manage Icons windowHelp
LanguageCodeENCode of the active language ("FR", "PT-BR", etc.)Help
LastExportFile(none)File of the last Export settings action, proposed as default for next exportHelp
LastExportFolder(working directory)Folder used for the last Export settings actionHelp
LastImportFolder(working directory)Folder used for the last Import settings actionHelp
LastModified(none)(Used in shared menus settings file only) Last file modification date-time of the shared menu ini file, taken from the file system and is be independent from various user's clocks or time zones. It is stored in the "yyyymmddhh24miss" format. Used to detect if a shared menu file was modified by another user since QAP was loaded.Help
LastVersionUsedAlpha0.0Last alpha version used (for internal use)
LastVersionUsedBeta0.0Last beta version used (for internal use)
LastVersionUsedProd0.0Last version used (for internal use)
LatestVersionSkipped0.0Last version skipped using the Check for update command (for internal use)
LatestVersionSkippedBeta0.0Last beta version skipped using the Check for update command (for internal use)
LeftControlDoublePressed0 (false)Open the QAP main menu by pressing the Left Control key twice within 400 ms (if 1)Help
MenuName(none)(Used in shared menus settings file only) Name of a shared menu shown in various dialog boxes and used as default name when user adds the shared menu from the Shared Menus CatalogueHelp
MenuReservedBy(none)(Used in shared menus settings file only) Windows logon name and computer name of the user currently editing the shared menu, menu is not reserved if emptyHelp
MenuType1(Used in shared menus settings file only) Type of shared menu: 1 (Personal), 2 (Collaborative) or 3 (Centralized)Help
NavigateOrLaunchHotkeyKeyboard#WKeyboard shortcut showing the QAP main menuHelp
NavigateOrLaunchHotkeyMouseMButtonMouse button/keyboard combination showing the QAP main menuHelp
NbLastActions10Maximum number of items in the Repeat Last Actions menuHelp
NbLiveFolderItemsMax500Maximum number of items in a menu (including submenus) for a Live Folder favoriteHelp
OpenMenuOnTaskbar1 (true)Allow the popup menu mouse hotkey to open the QAP menu when clicked over the Windows taskbarHelp
PopupFixPosition20,20Coordinate where the QAP popup menu is shown (x, y) when the PopupMenuPosition is set to "At fix position" (3) or as close as possible to it; x can be greater than the first screen limit to display the menu on a second screenHelp
PopupMenuPosition1Display the popup menu near the mouse position (1), at top-left of the active window (2) or at a fix positionHelp
QAPconnectFileManager(none)Name of the selected external file manager as it appears between square brackets in the QAPconnect.ini fileHelp
QAPconnectNewTabOrWindow(none)Instructs QAP to open folders in a new tab (if true) or in a new instance of the file manager selected in the QAPconnect list (if false)Help
QAPconnectPath(none)Path to the executable file of the file manager selected in the QAPconnect listHelp
RecentFoldersMax10Number of items to show in the Recent Folders menuHelp
RememberSettingsPosition1 (true)Remember the QAP Settings position when QAP is closed open the Settings at this location at next launchHelp
RightControlDoublePressed0 (false)Open the QAP main menu by pressing the Right Control key twice within 400 ms (if 1)Help
RunAsAdminfalseLaunch QAP with administrative privileges (from v8.7.1)Help
SearchWithStats0 (false)Select if the favorites list and search result list display additional columns with last modification date, creation date and, if the database is enabled, last usage date and usage frequency.Help
SettingsPosition-1 (center at minimal size)Position where Settings window will be displayed if RememberSettingsPosition option is 1 (true); X,Y,W,H (left, top, width and height)Help
Startups1Number of startups since the ini file was created (for internal use)
SwitchSettingsFolder(working directory)Folder of the last switched settings file, used as default for next switch actionHelp
ThemeWindowsCurrent theme used for Settings, various dialog boxes and popup menu colors, one of the themes in AvailableThemesHelp
TotalCommanderNewTabOrWindow(none)Parameter sent to Total Commander when opening a folder in a new window or tab ("/O /T" or "/N")Help
TotalCommanderPath(none)Path to the executable file of the file manager Total CommanderHelp
TotalCommanderUseTabs1 (true)Instructs QAP to open folders in a new tab (if true) or in a new instance of Total Commander (if false)Help
TotalCommanderWinCmd(none)Location of the wincmd.ini file whre are read the Total Commander hotlistHelp
UnderstandChangeFoldersInDialogRisk0 (false)Flag that uer read and accepted the caution note about trying to change forler in a non-file dialog boxHelp
UseClassicButtons0 (false)Display old back and white buttons in Settings windowHelp
UserBanner(none)Optional text added to the app name in the Settings window header, no validation of lenght, keep it short
WaitDelayInDialogBox100delay in milliseconds when changing folder in dialog box to help with an intermittent issue in in some apps like FirefoxHelp
WaitDelayInSnippet40|80|180Duration in milliseconds of three delays inserted while pasting text snippets (from v8.7.1.94)Help
WriteAccessMessage(none)(Used in shared menus settings file only) Message displayed to user having only read-only access to a centralized menu when they try to edit the menu. It can be used to direct the user to the menu administrator.
WriteAccessUsers(none)(Used in shared menus settings file only) Users who can edit a centralized shared menu, one or multiple Windows logon names, separated by coma or semi-colonHelp
SearchFromMain1 (true)When searching, scan favorites starting from Main menu (if false, searching starts from the menu currently displayed in the "Customize" window)
SearchWithLocale1 (true)When searching favorites in the "Customize" window, use the locale settings (e.g. making "�" considered as "e")

Why converting the settings file to Unicode?

From its beginning, Quick Access Popup is built with an Unicode architecture. This allows QAP to handle any type of characters and to be translated to any language.

However, last summer, thanks to a bug report from a Turkish user, I realized that the QuickAccessPopup.ini settings file was created using the ANSI encoding instead of Unicode. In his example, he found that a favorite folder including an “i without dot” like “D:\Yazılar\” was saved to the settings file as “D:\Yazilar\” with a dot on the “i”. The favorite was working well just after he created it. But as soon as the favorite was saved to settings and reloaded, the “ı” was converted to an “i” with a dot, making his favorite unusable.

“What makes Unicode so beneficial? Arguably that it, in essence, enables any character, letter or symbol to be represented using one single standard.”

To know more about Unicode, read this very good post: Unicode 101: An Introduction to the Unicode Standard. For a more technical reference, see this Wikipedia page.

QAP users are coming from everywhere around the world and Unicode encoding offers better support for international languages. This is why, starting with QAP v8.6, at startup, QAP prompts users of previous versions to convert the QuickAccessPopup.ini file to Unicode. This dialog box will be shown to the user only one time, and only if the QAP settings file is encoded with ANSI.

User can click:

  • Yes convert to Unicode to do the conversion;
  • No keep ANSI to keep its actual file encoding (a flag is added to the settings file to remember not to prompt the user again with this dialog box);
  • Ask me next time to prompt the user again at next QAP launch.

The only reason for choosing No would be if you encounter an issue after the conversion. From my tests, errors would occur only if you did some unusual manipulations of your settings file (see the note below). For the majority of users, the conversion should be done seamlessly.

If, after the Unicode conversion, you wish or need to return to the ANSI format, here is how to revert the conversion and return to the previous version:

  1. Make sure QAP is closed
  2. Go to the QAP working directory.
  3. Delete or rename the converted QuickAccessPopup.ini file.
  4. Rename QuickAccessPopup.ini-ANSI-BK to QuickAccessPopup.ini.
  5. Restart QAP and select No keep ANSI encoding.

Note: If your settings file was saved at some point using the UTF-8 No BOM encoding, this could cause issues (because this type of encoding cannot be distinguished from the ANSI encoding). But in normal use, Windows settings files (.ini) are always saved as ANSI or Unicode UTF-16 (Big Endian).

Why does QAP sometimes look frozen or takes time to show its popup menu?

Normally, the QAP popup menu shows instantly when you invoke it (by default, pressing the Middle Mouse Button or hitting Windows +W). But there are some situations external to QAP that sometimes prevent or delay the menu display. Here are the most common causes as well as available solutions. From the feedback received on the QAP Forum, the most common cause of delay is when you have menu items saved on an offline network drive. We will cover this in detail below. But first, let’s exclude some easier issues.

 

If you have questions or comments about this topic, you can add your post to this forum thread:
Why does QAP sometimes look frozen or takes time to show its popup menu?

Hardware issues

It has been reported that, sometimes, on some mouse, the wheel does not react when pressed. This can be a limitation of the mouse model or just a malfunctioning (see this video, for example). To confirm the issue, try replacing the mouse to see if the new mouse wheel can be pressed to open the QAP menu. If, in the end, the middle button is not available, you can select another mouse trigger in Options, Popup Hotkeys or use the keyboard trigger (by default Windows +W). More info here: How do I display the Quick Access Popup menu?

Check the exclusion list

In the Options, Popup Menu section, make sure you did not specify an unwanted exclusion in the Mouse Trigger Blacklist or that you did not select Whitelist without specifying the windows where the QAP menu could be activated. To reset the default setting, select the Blacklist radio button and make sure list is empty.

The menu does not open over some windows

This is probably because these windows belong to applications running as administrator. When an application is launched with an higher security privilege level (sometimes referred as ACL for Access Control List), its windows are not accessible to applications running with lower privilege. From QAP point of view, these windows are like black holes where the mouse middle click or keyboard trigger have no effect. More info here: Why is the middle mouse button not working over some windows?

Long refresh time

The QAP menu is built when you launch the app. It is refreshed each time you save your changes in the Customize or Options windows, and when you select the menu Tools, Refresh Live Folders and Shared menus.

In addition to that, some submenu are dynamic submenus and are refreshed each time you open the menu (if they appear in your menu). Refreshing these menu is very quick and should not cause any perceptible delay. These menu are: Recent Folders*, Recent Files*, Frequent Folders*, Frequent Files*, Drives*, Clipboard*, Current Windows, Reopen a Folder, Repeat Last Actions, Favorites in Customize window*, TC Directory hotlist and Directory Opus Favorites.

* These menus can cause a delay if they contain items on a network drive that is offline. See Network drives offline below.

In addition, the menu can be refreshed by a background task (see Can I schedule automatic menu refresh for Live folders and Shared menus?). If this options is enabled, the menu is temporarily unavailable while it is refreshed. If you have a very large menu with numerous submenus, shared menus and lengthy Live folders, the menu will not respond for a few seconds but only while it is refreshed (every 5 minutes by default).

Network drives offline

The main cause for delays long enough to let users think QAP is frozen is when an offline network drive contains favorites (folders or files) in the QAP menu. Starting with v11.0.7, QAP adds more robust protection against offline drives and add new options in Options, Menus Advanced Options. For more info, see: Can I create favorites on network drives?

If you encounter such delays and have a QAP version prior to v11.0.7, it is strongly recommended to upgrade to latest version.

Live folders and Shared menus on network drives

Also, you should avoid creating Live folders and Shared menus on network drives that could be offline. When refreshing its menu, QAP tries to read the content of Live folder and Shared menus to build its menu. An offline drive will cause a delay.

However, with QAP v11 or more recent, you could have a Live folder on a network drive and enable the new checkbox Refresh this Live Folder menu only with the command “Refresh Live Folders and Shared menus” (under the Live Folder Options) and avoid refreshing the menus when you know that a network drive is offline.

For users of older releases

If you use an older QAP version and have drives that are sometimes offline, there are a few things you can do to avoid this delay.

  • Stop retrieving icons for UNC drives: for QAP v10 only, in Options, Menu Icons, disable the checkbox Retrieve icons when refreshing Frequent folders and Frequent files menus (avoid if some files are often offline).
  • Remove the Frequent and Recent menus: by default, the Frequent Folders, Frequent Files, Recent Folders and Recent Files menus are inserted in the In the Works submenu; select them in the Customize window and click the Remove button.
  • Disable the QAP database: in Options, Database, uncheck the Enable Quick Access Popup database checkbox; this automatically remove the Frequent menus.
  • Remove the Drives menu (under My QAP Essentials) if you have network drives mapped to letter (like N:\); when refreshing this menu, QAP tries to retrieve the drive’s name and free space, causing a delay if the drive is offline.

QAP is running but my Customize window is not visible. What happened?

Each time you exit Quick Access Popup, the position of the Customize window and the Quick Launch window are saved in the settings file and restored the next time you open them.

The most probable explanation for the “disappearance” of these windows is that your screen configuration changed and that last positions of the windows are now not visible on your current screen(s) configuration (they are somewhere “outside” of the visible area of you screen). This issue could also be explained by Windows reporting an incorrect position.

To restore the default position of the Customize and Quick Launch windows, open the QAP system menu (right-click the QAP icon in the Notification zone) and select Tools, Restore “Customize” window position or Tools, Restore “Quick Launch” window position. The windows will now be centered in your main screen.

Right-click the QAP icon in the Notification zone to open the QAP system menu

The Manage Icons window is too large. How can I resize it or scroll the list?

Manage Icons – Click to enlarge

The tools I am using to develop QAP does not allow to add a scroll bar to a dialog box list when it contains multiple images per row as this one. This is why the Manage Icons window is presenting the icons page by page.

Each page contains as many icons as possible according to the size of your screen. The number of rows displayed in each page is calculated based on the screen size reported by Windows. If, for any reason, Windows returns an incorrect size value to QAP or if QAP misinterprets this info (which seems to be the case when screen scaling is active), the window could be too small or, more frequently, too large. This could make the window unusable because the Previous, Next and Close buttons could be “outside” of the screen.

The solution to this is to manually set the number of rows of this window. To do it, open the Options dialog box, Menu Icons tab (or Various Advanced Options tab starting with v11.5.7) , and enter a small number of rows in the Manage Icons window row zone. After testing it, increase the value up to the maximum that works on your screen.

More info about managing icons: Can I manage all my menu icons in one screen?

Why are the middle mouse button or keyboard shortcuts not working over some windows?

Most of the time, this issue is related to ACL (Windows Access Control List).

Each window in Windows is launched with a given set of rights. Basically, there are two levels:

  • user level (standard permissions)
  • administrator level (elevated permissions)

With elevated permissions (or privileges), user can make system changes that affect his configuration, security, etc. and that can also affect all other users on the system.

Quick Access Popup hotkey (by default, middle mouse button) only works on windows that have equal or lower access level. If you start an application with an higher “administrator” privileges (using the Run As Administrator Windows Explorer menu), QAP will not have the permission to open its menu over the windows created by this app. To do so, you would have to also launch QAP with administrator privileges.

Is it a good idea to launch QAP as Administrator? You have to know that every program started from QAP will the also inherit these enhanced rights. This could allow them to do changes on your system without prompting you. From a system security point of view, this may put your system at risk. In other words, you have to know what you are doing.

Why are QAP context menus not working in some windows?

In some setup, the QAP context menus may work well in Windows Explorer windows but not in a custom file manager.  Or the opposite.

This is generally because some applications are running with different access privileges.

For example, if your file manager is running with administrator permissions while QAPmessenger.exe (that app transmitting commands from context menus to QAP) is running with standard permissions, messages sent from the context menu could not be received by QAP. Maybe you should run your file manager with regular permission or, on the opposite, launch QAPmessenger.exe with elevated privileges.

The opposite could also be true: if QAP runs in admin mode and Windows Explorer (or your custom file manager) in standard mode, context menus in Explorer could not launch QAP commands because QAP has higher permissions than Explorer. Context menu can only call apps having privileges equal or lower than Windows Explorer has.

Please read more about Why is the middle mouse button not working over some windows?.

To find more about installation and enabling of Explorer context menu, read the Explorer Context Menus Help.

What is the “close menu issue”?

What I call the “close menu issue” is an intermittent issue (probably caused by Windows) preventing users from closing the QAP popup menu by clicking outside of the menu or by hitting the Escape key as they would do normally. As a result, users have to click an item to close the menu. This is annoying when a user opens the menu but changes its mind and does not want to launch any favorite.

This issue occurs intermittently under Windows 7 and Windows 10 (probably also with 8/8.1 or Windows 11). Some user are facing it frequently. Other, like me, see it only occasionally. There are probably others that never see it.

I tried various methods to get around this issue but, in the end, the changes I made in my code had side-effects worse than the initial issue. For this reason, I added the option Add “Close” to menus (in the Options window, Menu Appearance tab). If this option is turned on (checked), the Close this menu entry is automatically added to the main QAP popup menu, to the Alternative menu, to all dynamic menus and to menu that can be open by a shortcut or a hotstring. This option is turned on by default.

 

What if you never encounter this issue?

If you are always able to close the QAP popup menu by clicking outside of the menu or by hitting the Escape key, you can save the space taken by the Close this menu entries. In the Options, deselect the Add “Close” to menu check box.

QAP stops loading with an error message. What happened?

If you use QAP v11.5.3 or more recent, you could see this message alerting you that the last time your favorites were saved, QAP was interrupted before completing its task. When this happens, QAP loads your previous settings and your recent changes are lost. To avoid this error in the future, make sure QAP completes its saving before turning off your computer.

You could also see this error message.

Two reasons can explain this error message:

1) something wrong happened interrupting QAP while it was saving your settings and QAP could not react to fix it;

or 2) you edited the settings file manually and did not respect the structure of the settings file (see What is the structure of QAP settings (ini) file?)

The easiest way to solve this issue is to restore your latest settings backup. You can do it by renaming your current QuickAccessPopup.ini to QuickAccessPopup-broken.ini and renaming your latest backup to QuickAccessPopup.ini.

  1. Open the QAP working directory in your file manager. In the Customize window, select File, Open QAP working directory (pre-v10 users, see What’s the QAP working directory?).
  2. Close QAP before renaming the settings file: select File, Exit Quick Access Popup.
  3. Rename QuickAccessPopup.ini to QuickAccessPopup-broken.ini.
  4. Find your latest backup file and copy it in your QAP working directory. Your backup files are saved in the Main settings file backup folder set in Options, General tab.
  5. Rename this file from something like QuickAccessPopup-backup-20210219.ini (the last part of the file name is the backup date in “YYYYMMDD” format) to QuickAccessPopup.ini.
  6. Restart QAP.

Why does dialog boxes sometimes refuse to change folder?

 

First, make sure the change folder in dialog box option is enabled. See: Can I change folders in file dialog boxes (Open, Save As, etc.)?

There seems to be an intermittent issue noted in Firefox (and possibly other apps) that interrupt the change folder action initiated by QAP.

Normally, QAP introduces a 100 ms delay at a given step when changing folder in dialog boxes. Making this delay longer may help. In my tests, it increased success rate in Firefox dialog boxes (without resolving the issue completely, unfortunately).

To change this delay, select Options, Various Advanced Options and update the value as shown below. 100 is the default value (in milliseconds). Increase it to 200 (or more) to see how it improves changing folders in Firefox or other apps.

 


Feel free to use the QAP Forum to give feedback on this issue.

 

Why some buttons or icons are not displayed correctly in the Customize window?

This is probably because you enabled screen scaling (under Windows 10 Settings, Ease of Access, Display) as most users with an High-DPI (HDPI) displays (like Surface Book) do. This can cause two issues.

First, with QAP versions before v11.5.3, some buttons intended to be centered were shifted to the right of the window and could overlap with other components of the window. This has been fixed with QAP v11.5.3.

The other issue is that icons on QAP windows are not scaled and look smaller than on screens with regular DPI. See this example (taken from an old QAP version but this has not changed since): on the left, the Customize window on a standard desktop PC and, on the right, the same window on a Surface Book.

To solve it, you can set a Windows compatibility option to fix the high DPI scaling behavior. This may affect the quality of your display and you could prefer to keep the small buttons. Here is how you can try this setting:

  1. Find the Quick Access Popup executable file (normally in C:\Program Files\Quick Access Popup).
  2. Right-click the QuickAccessPopup.exe executable icon in Windows Explorer.
  3. Select Properties, then Compatibility, then Change high DPI settings.
  4. In the new dialog box, check Override high DPI scaling behavior and select System (Enhanced) or System from the dropdown list. Choose the option that gives the best results on your screen.
  5. It is recommended to reboot the computer in order to enforce the change and clear out older settings or window displays.

Labels or options can vary depending on your Windows 10 version. Thanks to QAP user Jörg Giencke, you can use this tip from brianapps (the developer of Sizer 4.0).

I upgraded from a pre-v8 QAP version, why don’t I see the icons in my menu?

2016-12-30-18_03_19-manage-icons-quick-access-popup-v8NOTE: The following info is for users who upgraded to QAP from a version before v8.

Icons management has been greatly improved when QAP v8 was introduced. To make sure QAP won’t overwrite the custom icons you have added to your menu, QAP will not update your icons automatically to the new icons. I prefer to let you oversee the replacement of old icons using the new Manage Icons dialog box.

A bit of background…

If you started using QAP before v8, your menu includes icons taken from Windows system files shell32.dll and imageres.dll. These icons library files are installed with every Windows version. To use one of these icons, QAP had to specify their positions (numeric index) in the library.  The issue with these files is that, from one Windows version to the other, icons were added, removed or moved in the library. This caused me headaches and a lot of tedious work to keep track with these always changing index numbers for the various Windows version of QAP users.

In addition, if you upgraded to a new Windows version, chances are that some of your icons were replaced with an image not related to the favorite.

With QAP v8+, this headache is behind us. I decided to invest some money to buy a licence to include the nice icons from Icons8 (you can help me share this expense, if you wish). With my own icons library, I now rely on stable library file named JLicons.dll. If you installed QAP with the “Easy Setup” mode, this file JLicons.dll is saved in the shared applications folder C:\Program\Data\JeanLalonde\. If you preferred the “Portable” mode, the file is included in the portable ZIP file and must be kept in the same folder as QAP executable file.

Now, to see these new icons, please use the Manage Icons dialog box and click on the default icons on the right side of the screen to select them.

 

 

Can QAP run if I’m using a Russian keyboards?

One of my goals with QAP is to make it run on as many international systems as possible. But programming hotkeys on a Russian keyboard is a challenge for a non-Russian developer like me living in Canada. Russian keyboards are very different from most of those used in America or Europe. Up to QAP v8.6.x, launching QAP on a system with Russian keyboard was giving error messages and configuration issues making the app unusable.

Starting with version v8.7, changes has been made to QAP code when running with Russian keyboard:

  • at first execution, default keyboard hotkeys showing the popup menu (normally Windows + W and Shift + Windows + W) are changed for Windows + ц and Shift + Windows + ц . I choose the “ц” character (ASCII Unicode 0419) because it is located at the “w” location on my keyboards. Users can change it in QAP Options, Popup Hotkeys tab;
  • at first execution, to avoid startup errors, QAP will not creates default hotkeys for frequently used features as it would normally do, letting users create their preferred hotkeys themselves;
  • QAP internal hotkeys available in the Customize window are disabled because they were creating errors.

Important for QAP existing users: on systems with a Russian keyboard, it is recommended to first run QAP with a *fresh* install (making sure the file QuickAccessPopup.ini does *not* exist when you launch QAP). QAP will then create a new QuickAccessPopup.ini OK for Russian keyboard. If you had favorites in a previous installation, import them in the new installation from a backup of your settings.

Video – Save thousands of clicks (2 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Boost your efficiency with Quick Access Popup (1h 29m)

Presentations videos

Demo videos

Video – Tutorial Select a file and use it as a parameter for any command (17 min.)

In this tutorial with Joe Glines, you will see how you can select a file and use it as a parameter for a DOS command, a batch file or any application that accepts parameters.

As an example, Joe use this tip to shrink his video files by selecting them and simply hitting a QAP shortcut. Users who often run batch files, scripts, etc. will find that this simple technique can improve greatly the flexibility of their tools.

Presentations videos

Demo videos

Video – Tutorial Turn a folder in a dynamic menu with Live Folders (13 min.)

In this tutorial, Joe Glines and I show you how QAP can dynamically turn a folder and its subfolders into a menu and submenus to give you quick access to your folders and files.

Presentations videos

Demo videos

Video – Tutorial Using Placeholders in your Snippets and Favorites locations (10 min.)

In this tutorial, see how QAP placeholders can make your snippets more powerful! You will see how placeholders in your favorites locations can make them dynamically flexible.

Presentations videos

Demo videos

Video – Tutorial How to Quickly Automate Web Forms (10 min.)

In this tutorial, Joe and I demonstrate how to automate the completion of a form in one click with the QAP Macro Snippets!

Presentations videos

Demo videos

Video – Tutorial on commands from QAP Features (QAP Features 2/2) (9 min.)

In our tutorial, this week, Joe and I demonstrate how to add useful commands from the QAP Features favorites.

For example: easily reopen a folder, force window always on top, quickly add a snippet & more.

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Tutorial on QAP Dynamic menus (QAP Features 1/2) (6 min.)

Joe Glines is doing great videos on his The-Automator YouTube channel. Last week, we started doing tutorials on Quick Access Popup! We hope this will help demonstrate it’s power.

This week we demonstrate how to quickly access: Recent Folders, Drives, Clipboard, etc.

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Quick Access Popup Installation Demo (6 min.)

Presentations videos

Demo videos

Video – Beautiful and efficients menu with icons (12 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Interview What’s new since QAP v10 (60 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – What’s new in QAP v10 (14 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Multiple-monitor support (15 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – 12 ways to popup your QAP menu (17 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – QAP and Directory Opus 2/2 (15 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – QAP and Directory Opus 1/2 (16 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Users Variables (11 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – The “In the Works” menu (12 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Quick Access Popup Webcast Demo (42 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – Reopen Current Folder in Dialog Box (1 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

Video – First steps with Quick Access Popup (9 min.)

View, comment or LIKE this post on our YouTube channel

Presentations videos

Demo videos

1 2