Skip to main content

​
Configuration File Location

ImageGlass stores user settings in igconfig.json, a JSON-based configuration file.

​
Default Locations

Path: %APPDATA%\ImageGlass\Settings\igconfig.jsonThis is the primary location for user-specific settings.
Path: [ImageGlass Installation]\Settings\igconfig.jsonWhen running in portable mode, settings are stored alongside the application.

​
Configuration File Structure

The configuration file follows this basic structure:
igconfig.json
{
  "_Metadata": {
    "Description": "ImageGlass configuration file",
    "Version": 9.1
  },
  "AutoUpdate": "0",
  "EnableSlideshow": false,
  "ShowToolbar": true,
  "DarkTheme": "Kobe",
  "LightTheme": "Kobe-Light",
  // ... additional settings
}

​
Metadata Section

​
_Metadata.Description
string
Human-readable description of the configuration file
​
_Metadata.Version
number
Configuration file version (current: 9.1)

​
Configuration Categories

ImageGlass settings are organized into several categories:

General

Startup behavior, auto-update, multi-instance support

Image

Loading orders, color management, format support

Viewer

Zoom modes, panning, navigation controls

Performance

Image Booster cache, async loading, gallery cache

Appearance

Themes, colors, toolbar customization

Advanced

Power user settings, debugging, hidden options

​
Settings Management

​
Accessing Settings

You can access ImageGlass settings in multiple ways:
  1. Settings UI: Open ImageGlass → Menu → Settings
  2. Direct File Editing: Edit igconfig.json with any text editor
  3. Command Line: Use igcmd.exe for configuration management
Always backup your configuration file before making manual edits. Invalid JSON will cause ImageGlass to use default settings.

​
Reset to Defaults

To reset all settings to defaults:
1

Close ImageGlass

Ensure all ImageGlass instances are closed
2

Delete Configuration File

Delete igconfig.json from your configuration directory
3

Restart ImageGlass

Launch ImageGlass - it will create a new configuration file with defaults

​
Configuration API Version

ImageGlass uses version 9 for configuration compatibility checking. Settings from older versions are automatically migrated when detected.

​
Version History

  • Version 9.x: Current configuration format (ImageGlass 9.x)
  • Version 8.x: Legacy format (auto-migrated)
  • Version 7.x and earlier: Legacy format (auto-migrated)

​
Data Types

Configuration values use standard JSON data types:
​
Boolean
boolean
true or false values for feature togglesExample: "ShowToolbar": true
​
Number
number
Integer or floating-point numbers for dimensions, speeds, etc.Example: "ThumbnailSize": 50
​
String
string
Text values for paths, names, colors (hex format)Example: "DarkTheme": "Kobe"
​
Array
array
Lists of values for zoom levels, formats, etc.Example: "ZoomLevels": [10, 25, 50, 100, 200]
​
Object
object
Complex structures for toolbar buttons, hotkeys, toolsExample: "MenuHotkeys": { "MnuOpen": ["Ctrl+O"] }

​
Next Steps

Appearance Settings

Customize themes and visual appearance

Performance Tuning

Optimize cache and loading settings

Advanced Configs

Explore power user options

Themes

Install and manage theme packs

Build docs developers (and LLMs) love

Get started for freeTalk to us