Learn how to control ImageGlass over configuration, pre-define or even lock some settings at installation.
Configuration directory
There are 2 phrases when talking about the working directory in ImageGlass:
-
Startup dir: is the folder where ImageGlass.exe located in, also called as installed dir. E.g:
C:\Program Files\ImageGlass\ -
Config dir: is the folder that contains ImageGlass setting file (igconfig.xml) and others, located in
%AppData%\ImageGlass\. In portable mode, Config dir is also Startup dir. If ImageGlass does not have write permission to Startup dir, it will use %AppData%\ImageGlass\ instead.
Configuration files
ImageGlass knows of 3 different files, which are loaded in the following order:
-
igconfig.default.xml, located in Startup dir, specifies the defaults which are used if no other settings are available at first start. -
igconfig.xml, located in Config dir, contains all user settings, written by ImageGlass after closing. This overrules the settings in theigconfig.default.xmlfile. -
igconfig.admin.xml, located in Startup dir, contains the settings which will overrule all settings in the files above.
ImageGlass will look for every mentioned file, in the described order, and the locations. The configuration is built from zero, setting for setting, by using the following 4 steps:
- Take the default set by the developer.
- If a
igconfig.default.xmlwas found, and the settings can be found in there, it will override the values from step 1. - If a
igconfig.xmlwas found, and the setting can be found in there, it will override the values from step 2. - If a
igconfig.admin.xmlwas found, and the setting can be found in there, it will override the values from step 3.
ImageGlass will use the resulting setting, and when every single setting in the complete configuration is processed, it will write the complete configuration to it's igconfig.xml file (and only there).
Upgrade guide
When you upgrade ImageGlass to a newer version, you may get a message box warning that some settings are not compatible and you should update them before continuing. This section will list down breaking changes from the settings that you should apply maunally in your configuration files.
Upgrading to 7.5
| Setting | Old value | New value |
|---|---|---|
| Array item separator |
,E.g. key="FrmMainWindowsBound" value="280,125,1329,849"
|
;E.g. key="frmMain.WindowsBound" value="280;125;1329;849"key="ToolbarButtons" value="btnBack;btnNext;Separator;"
|
| Pair value item separator in array |
,E.g. key="KeyboardActions" value="0,0;1,3;"
|
;E.g. key="KeyboardActions" value="LeftRight:PrevNextImage;PageUpDown:PrevNextImage;"
|
| List item value stored as |
numberE.g. key="ToolbarPosition" value="0"key="ToolbarButtons" value="0,1,-1"
|
item nameE.g. key="ToolbarPosition" value="Top"key="ToolbarButtons" value="btnBack;btnNext;Separator;"
|