I’m upgrading from Folders Popup. Can I import my favorites and option settings?

Everything possible is made to facilitate the transition from Folders Popup to Quick Access Popup.

The ImportFPsettings utility helps you do the transition from Folders Popup.

  • It imports favorites from Folders Popup and convert them to QAP format.
  • It also import options settings and hotkeys and adapt them to QAP.

Only Folders Popup groups settings cannot be imported to QAP settings. The group implementation has been completely reviewed in QAP, integrating them with favorites as if they were as special kind of submenus, making it difficult to import.

If you install QAP using the standard Setup program, make sure the Import Folders Popup settings and favorites option is checked during installation. The utility will be automatically executed after the initial QAP installation (if you preferred the portable installation, you must run ImportFPsettings manually).

Take note that ImportFPsettings replaces all favorites that could exist in QAP and overwrites existing option settings. It is recommended to use it when you just installed QAP.

After you installed QAP, do not forget to uninstall Folders Popup or, at least, remove it from your Startup group: uncheck Run at Startup in Folders Popup Options dialog box (first tab).

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

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 an names:
1 FavoriteType
2 FavoriteName
3 FavoriteLocation
4 FavoriteIconResource
5 FavoriteArguments
6 FavoriteAppWorkingDir
7 FavoriteWindowPosition
8 FavoriteLaunchWith
9 FavoriteLoginName
10 FavoritePassword
11 FavoriteGroupSettings

Example

[Favorites]
Favorite1=Folder|Windows|C:\Windows|C:\Windows\System32\shell32.dll,298|||||||
Favorite2=Document|My Notes|C:\Docs\notes.txt||||||||

Info on the internal data structure of each element and on special uses of some items can be found on QAP's wiki (section Favorite Object Model).

[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: Quick Access Popup Color Themes.

[AlternativeMenuHotkeys] section

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

[LocationHotkeys] section

This section contains 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.

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, 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)?

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

The Import/Export Settings QAP feature can be uses for two reasons:

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

To open the Import/Export Settings dialog box, right-click the QAP icon in the Notification zone and click Import/Export Settings. If you use this command often, you can also add the Import/Export Settings command to your QAP menu by adding a QAP Feature.

In the Import/Export Settings dialog box:

  1. Click the Export or Import buttons.
  2. Choose the Source file to import or the Destination file that will be created (if it does not exist) to store your exported data. The last source and destination files are remembered and displayed as default
  3. Choose to import or export any or all of these settings groups: favorites, hotkeys, alternative menu hotkeys, global settings and themes.
  4. Click the Export or Import button.
  5. Alerts will inform you if existing settings are to be overwritten in the destination file and a report will summarize the completed actions.

Export Tips

  • Starting with v8.1.1, when exporting settings, you can use the following placeholders in the file name, allowing you to save different export files without having to give new file names:
    • %A_Now% will be translated to the current local date-time of your computer and
    • %A_NowUTC% to the current Coordinated Universal Time (still based on you computer time),
    • using YYYYMMDDHH24MISS format,
    • for example, as I write this, the file name my-export-%A_Now%.ini would be converted to my-export-20170228193600.ini.

Import Tips

  • When importing favorites, you can choose to:
    • replace the favorites currently in your QuickAccessPopup.ini file
    • or append the favorite to the existing one.
    • IMPORTANT NOTE: If you choose to append favorites, make sure that there are no duplicates names in the favorites (or submenus) in your existing Main menu and in the favorites in your imported Main menu. Currently, QAP does not check for name duplicates and if a name conflict occurs, your menu could become offset depending on the position (and number) of duplicates.
  • 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?.