Advanced Configuration

Power user settings and hidden configuration options for ImageGlass

Window State & Position

ImageGlass saves window state and position between sessions. These settings are automatically managed but can be manually configured.

Main Window

FrmMainPositionX · number · default: "200"

X coordinate of main window position in pixels

FrmMainPositionY · number · default: "200"

Y coordinate of main window position in pixels

FrmMainWidth · number · default: "1300"

Width of main window in pixels

FrmMainHeight · number · default: "800"

Height of main window in pixels

FrmMainState · string · default: "Normal"

Window state at startup

Options:

• "Normal" - Standard window
• "Maximized" - Maximized window
• "Minimized" - Minimized window (not recommended)

Settings Window

FrmSettingsPositionX · number · default: "200"

X coordinate of settings window

FrmSettingsPositionY · number · default: "200"

Y coordinate of settings window

FrmSettingsWidth · number · default: "1300"

Width of settings window

FrmSettingsHeight · number · default: "800"

Height of settings window

FrmSettingsState · string · default: "Normal"

Settings window state

Zoom Configuration

Zoom Levels

ZoomLevels · array · default: "[]"

Custom zoom levels as percentages

Format: Array of numbers representing percentages

Example:

"ZoomLevels": [10, 25, 50, 75, 100, 125, 150, 200, 400, 800]

Empty array uses automatic zoom levels.

ZoomMode · string · default: "AutoZoom"

Default zoom mode

Options:

• "AutoZoom" - Fit to window
• "LockZoom" - Fixed zoom ratio
• "ScaleToWidth" - Fit width
• "ScaleToHeight" - Fit height
• "ScaleToFill" - Fill window
• "ActualSize" - 100% zoom

ZoomLockValue · number · default: "100.0"

Fixed zoom percentage when using LockZoom mode

Minimum: 0 (uses 100% as fallback)

ZoomSpeed · number · default: "0"

Zoom acceleration/deceleration

Range: -500 to 500

• Negative values: Slower zooming
• 0: Default speed
• Positive values: Faster zooming

Image Interpolation

ImageInterpolationScaleDown · string · default: "MultiSampleLinear"

Interpolation when zoom < 100%

Options:

• "NearestNeighbor" - Fastest, pixelated
• "Linear" - Fast, smooth
• "Cubic" - High quality
• "MultiSampleLinear" - Balanced (recommended)
• "Anisotropic" - Highest quality
• "HighQualityBicubic" - Professional quality

ImageInterpolationScaleUp · string · default: "NearestNeighbor"

Interpolation when zoom > 100%

Same options as ScaleDown. NearestNeighbor preserves sharp edges when zooming in.

Panning

PanSpeed · number · default: "20.0"

Panning speed multiplier

Range: 0-100

• Lower values: Slower, more precise panning
• Higher values: Faster panning

Mouse & Keyboard Actions

Mouse Wheel Actions

MouseWheelActions · object · default: "{}"

Configure mouse wheel behavior with modifiers

Structure:

{
  "Scroll": "Zoom",
  "CtrlAndScroll": "BrowseImages",
  "ShiftAndScroll": "PanHorizontally",
  "AltAndScroll": "PanVertically"
}

Action Options:

• "DoNothing" - No action
• "Zoom" - Zoom in/out
• "PanVertically" - Pan up/down
• "PanHorizontally" - Pan left/right
• "BrowseImages" - Next/previous image

Mouse Click Actions

MouseClickActions · object · default: "{}"

Configure mouse click actions

Example:

{
  "DoubleClick": "ToggleFullScreen"
}

Menu Hotkeys

MenuHotkeys · object · default: "{}"

Custom keyboard shortcuts for menu items

Structure:

{
  "MnuOpen": ["Ctrl+O", "O"],
  "MnuSave": ["Ctrl+S"],
  "MnuDelete": ["Delete", "Shift+Delete"]
}

Each menu item can have multiple hotkey combinations.

File Format Support

FileFormats · string · default: "(See below)"

Semicolon-separated list of supported file extensions

Default formats: .3fr;.apng;.ari;.arw;.avif;.b64;.bay;.bmp;.cap;.cr2;.cr3;.crw;.cur;.cut;.dcr;.dcs;.dds;.dib;.dng;.drf;.eip;.emf;.erf;.exif;.exr;.fff;.fits;.flif;.gif;.gifv;.gpr;.hdp;.hdr;.heic;.heif;.hif;.ico;.iiq;.jfif;.jp2;.jpe;.jpeg;.jpg;.jxl;.jxr;.k25;.kdc;.mdc;.mef;.mjpeg;.mos;.mrw;.nef;.nrw;.obm;.orf;.pbm;.pcx;.pef;.pgm;.png;.ppm;.psb;.psd;.ptx;.pxn;.qoi;.r3d;.raf;.raw;.rw2;.rwl;.rwz;.sr2;.srf;.srw;.svg;.tga;.tif;.tiff;.viff;.wdp;.webp;.wmf;.wpg;.x3f;.xbm;.xpm;.xv

Add custom formats carefully - ImageGlass may not render unsupported types

Clipboard Operations

EnableCopyMultipleFiles · boolean · default: "true"

Allow copying multiple selected files to clipboard

EnableCutMultipleFiles · boolean · default: "true"

Allow cutting multiple selected files to clipboard

Edit Actions

Edit Apps

EditApps · object · default: "{}"

Configure external editing applications per file type

Structure:

{
  ".jpg": {
    "AppName": "Photoshop",
    "Executable": "C:\\Program Files\\Adobe\\Photoshop\\photoshop.exe",
    "Argument": "<file>"
  }
}

Use <file> macro for the current image path.

AfterEditingAction · string · default: "Nothing"

Action after launching external editor

Options:

• "Nothing" - Keep ImageGlass open
• "Minimize" - Minimize ImageGlass
• "Close" - Close ImageGlass

ImageEditQuality · number · default: "80"

JPEG quality when saving edited images (0-100)

ShouldPreserveModifiedDate · boolean · default: "false"

Preserve original file modification date when saving

OpenSaveAsDialogInTheCurrentImageDir · boolean · default: "true"

Open Save As dialog in current image’s directory

Confirmation Dialogs

ShowDeleteConfirmation · boolean · default: "true"

Show confirmation before deleting files

ShowSaveOverrideConfirmation · boolean · default: "true"

Show confirmation before overwriting files

Color Management

ColorProfile · string · default: "CurrentMonitorProfile"

Color profile for image display

Options:

• "None" - No color management
• "CurrentMonitorProfile" - Use monitor’s ICC profile
• File path to custom ICC/ICM profile

Example: "ColorProfile": "C:\\Windows\\System32\\spool\\drivers\\color\\sRGB.icm"

ShouldUseColorProfileForAll · boolean · default: "false"

Apply color profile to images without embedded profiles

Update Configuration

AutoUpdate · string · default: "(ISO 8601 date)"

Last auto-update check timestamp in ISO 8601 format

Special Values:

• "0" - Disable automatic update checks
• ISO date string - Last check time

Example: "AutoUpdate": "2026-03-08T00:00:00Z"

ShowNewVersionIndicator · boolean · default: "false"

Display new version indicator badge

Session State

LastSeenImagePath · string · default: ""

Path to last viewed image

ShouldOpenLastSeenImage · boolean · default: "true"

Reopen last image on startup

LastOpenedSetting · string · default: ""

Last opened settings tab (internal use)

Multiple Instances

EnableMultiInstances · boolean · default: "true"

Allow multiple ImageGlass windows

Disabling this may interfere with some workflows

In-App Messages

InAppMessageDuration · number · default: "2000"

Duration of in-app notifications in milliseconds

Example: "InAppMessageDuration": 3000 (3 seconds)

Image Info Tags

ImageInfoTags · array

Information displayed in the image info overlay

Default tags:

[
  "Name",
  "ListCount",
  "FrameCount",
  "Zoom",
  "Dimension",
  "FileSize",
  "ColorSpace",
  "ExifRating",
  "DateTimeAuto",
  "AppName"
]

Customize which metadata appears in the viewer.

Slideshow Settings

SlideshowInterval · number · default: "5.0"

Slideshow interval in seconds (minimum)

Minimum: Must be > 0

SlideshowIntervalTo · number · default: "5.0"

Maximum slideshow interval for random mode

UseRandomIntervalForSlideshow · boolean · default: "false"

Use random interval between min and max

SlideshowImagesToNotifySound · number · default: "0"

Play notification sound every N images (0 = disabled)

EnableLoopSlideshow · boolean · default: "true"

Loop back to first image at end of slideshow

EnableFullscreenSlideshow · boolean · default: "true"

Start slideshow in fullscreen mode

HideMainWindowInSlideshow · boolean · default: "true"

Hide main window when slideshow starts

ShowSlideshowCountdown · boolean · default: "true"

Display countdown timer in slideshow

Navigation

EnableLoopBackNavigation · boolean · default: "true"

Loop to first image when reaching the last image

Tools Configuration

Tools · array · default: "[{ExifGlass}]"

External tools integrated with ImageGlass

Structure:

[
  {
    "ToolId": "Tool_ExifGlass",
    "ToolName": "ExifGlass - EXIF metadata viewer",
    "Executable": "exifglass",
    "Argument": "<file>",
    "IsIntegrated": true,
    "Hotkeys": ["X"]
  }
]

ToolSettings · object · default: "{}"

Settings storage for integrated tools (managed by tools)

Disabled Menus

DisabledMenus · array · default: "[]"

List of menu IDs to hide/disable

Example:

"DisabledMenus": ["MnuDelete", "MnuEdit"]

Useful for kiosk or restricted environments.

Quick Setup

QuickSetupVersion · number · default: "0.0"

Version of Quick Setup last completed

When < 9.0, Quick Setup dialog appears on startup.

Debug Mode

EnableDebug · boolean · default: "false"

Enable debug logging and diagnostics

Performance impact - use only for troubleshooting

Example Advanced Configuration

igconfig.json

{
  "_Metadata": {
    "Description": "ImageGlass configuration file",
    "Version": 9.1
  },
  
  // Window configuration
  "FrmMainWidth": 1920,
  "FrmMainHeight": 1080,
  "FrmMainState": "Maximized",
  
  // Custom zoom levels
  "ZoomLevels": [10, 25, 50, 75, 100, 150, 200, 400, 800, 1600],
  "ZoomMode": "AutoZoom",
  
  // Mouse actions
  "MouseWheelActions": {
    "Scroll": "Zoom",
    "CtrlAndScroll": "BrowseImages"
  },
  
  // Custom hotkeys
  "MenuHotkeys": {
    "MnuDelete": ["Delete"],
    "MnuFullScreen": ["F11", "F"]
  },
  
  // Advanced editing
  "EditApps": {
    ".jpg": {
      "AppName": "Photoshop",
      "Executable": "C:\\Program Files\\Adobe\\Photoshop\\photoshop.exe",
      "Argument": "<file>"
    },
    ".png": {
      "AppName": "GIMP",
      "Executable": "C:\\Program Files\\GIMP\\bin\\gimp.exe",
      "Argument": "<file>"
    }
  },
  
  // Disable auto-update
  "AutoUpdate": "0"
}

See Also

Performance

Performance optimization settings

Appearance

Visual customization