Advanced Configuration

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 startupOptions:

"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 percentagesFormat: Array of numbers representing percentagesExample:

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

Empty array uses automatic zoom levels.

ZoomMode

string

default:"AutoZoom"

Default zoom modeOptions:

"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 modeMinimum: 0 (uses 100% as fallback)

ZoomSpeed

number

default:"0"

Zoom acceleration/decelerationRange: -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 multiplierRange: 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 modifiersStructure:

{
  "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 actionsExample:

{
  "DoubleClick": "ToggleFullScreen"
}

Custom keyboard shortcuts for menu itemsStructure:

{
  "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 extensionsDefault 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 typeStructure:

{
  ".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 editorOptions:

"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 displayOptions:

"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 formatSpecial 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 millisecondsExample: "InAppMessageDuration": 3000 (3 seconds)

Image Info Tags

ImageInfoTags

array

Information displayed in the image info overlayDefault 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

Loop to first image when reaching the last image

Tools Configuration

Tools

array

default:"[{ExifGlass}]"

External tools integrated with ImageGlassStructure:

[
  {
    "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/disableExample:

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

Useful for kiosk or restricted environments.

Quick Setup

QuickSetupVersion

number

default:"0.0"

Version of Quick Setup last completedWhen < 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"
}

Performance

Performance optimization settings

Appearance

Visual customization

Get Started

User Guide

Configuration

Advanced Features

Advanced Configuration

Window State & Position

Main Window

Settings Window

Zoom Configuration

Zoom Levels

Image Interpolation

Panning

Mouse & Keyboard Actions

Mouse Wheel Actions

Mouse Click Actions

Menu Hotkeys

File Format Support

Clipboard Operations

Edit Actions

Edit Apps

Confirmation Dialogs

Color Management

Update Configuration

Session State

Multiple Instances

In-App Messages

Image Info Tags

Slideshow Settings

Navigation

Tools Configuration

Disabled Menus

Quick Setup

Debug Mode

Example Advanced Configuration

See Also

Performance

Appearance

Build docs developers (and LLMs) love

Get Started

User Guide

Configuration

Advanced Features

​Window State & Position

​Main Window

​Settings Window

​Zoom Configuration

​Zoom Levels

​Image Interpolation

​Panning

​Mouse & Keyboard Actions

​Mouse Wheel Actions

​Mouse Click Actions

​Menu Hotkeys

​File Format Support

​Clipboard Operations

​Edit Actions

​Edit Apps

​Confirmation Dialogs

​Color Management

​Update Configuration

​Session State

​Multiple Instances

​In-App Messages

​Image Info Tags

​Slideshow Settings

​Navigation

​Tools Configuration

​Disabled Menus

​Quick Setup

​Debug Mode

​Example Advanced Configuration

​See Also

Performance

Appearance

Build docs developers (and LLMs) love

Window State & Position

Main Window

Settings Window

Zoom Configuration

Zoom Levels

Image Interpolation

Panning

Mouse & Keyboard Actions

Mouse Wheel Actions

Mouse Click Actions

Menu Hotkeys

File Format Support

Clipboard Operations

Edit Actions

Edit Apps

Confirmation Dialogs

Color Management

Update Configuration

Session State

Multiple Instances

In-App Messages

Image Info Tags

Slideshow Settings

Navigation

Tools Configuration

Disabled Menus

Quick Setup

Debug Mode

Example Advanced Configuration

See Also