Skip to main content

​
Theme Configuration

ImageGlass supports separate themes for light and dark modes, allowing seamless transitions based on your Windows system theme.

​
Theme Selection

​
string
default:"Kobe"
Theme pack name to use when Windows is in dark modeExample: "DarkTheme": "Kobe"
​
string
default:"Kobe-Light"
Theme pack name to use when Windows is in light modeExample: "LightTheme": "Kobe-Light"

​
Built-in Themes

ImageGlass includes these default themes:
  • Kobe (Dark) - Modern dark theme with accent colors
  • Kobe-Light (Light) - Clean light theme variant
Learn how to install additional themes in the Themes section.

​
Background Colors

​
Viewer Background

​
string
default:"(follows theme)"
Background color of the main viewer area in hex formatValues:
  • Empty string "" - Use theme’s default background color
  • Hex color - Custom color (e.g., "#1e1e1e", "#ffffff00" with alpha)
Example: "BackgroundColor": "#2b2b2b"
​
boolean
default:"false"
Display checkerboard pattern for transparent images
​
boolean
default:"false"
Limit checkerboard to image bounds only (not full viewer)

​
Slideshow Background

​
string
default:"#000000"
Background color for slideshow modeExample: "SlideshowBackgroundColor": "#000000"

​
Window Appearance

​
Window Backdrop

​
string
default:"Mica"
Windows 11 acrylic/material effect for the windowOptions:
  • "None" - No backdrop effect
  • "Mica" - Windows 11 Mica material (recommended)
  • Other Windows 11 backdrop styles

​
Window Icon

​
boolean
default:"true"
Display ImageGlass icon in the title bar

​
Toolbar Appearance

​
Toolbar Layout

​
boolean
default:"true"
Show/hide the main toolbar on startup
​
boolean
default:"true"
Center toolbar buttons horizontally
​
number
default:"24"
Height of toolbar icons in pixelsRange: 16-48 pixelsExample: "ToolbarIconHeight": 32
​
boolean
default:"false"
Automatically hide toolbar in fullscreen mode
​
boolean
default:"true"
Show/hide the thumbnail gallery panel
​
boolean
default:"false"
Display scrollbars in the gallery panel
​
boolean
default:"true"
Show filename below thumbnails
​
number
default:"50"
Thumbnail size in pixelsMinimum: 20 pixelsExample: "ThumbnailSize": 70
​
number
default:"3"
Number of thumbnail columns in vertical gallery layoutMinimum: 1 column
​
boolean
default:"false"
Auto-hide gallery in fullscreen mode
​
boolean
default:"true"
Show left/right arrow navigation buttons on the viewer
Navigation button appearance is controlled by the active theme’s SVG icons.

​
Welcome Image

​
boolean
default:"true"
Display welcome image when no image is loaded

​
Fullscreen & Special Modes

​
Frameless Mode

​
boolean
default:"false"
Enable frameless window mode (no title bar or borders)
Hold Shift key to move the window in frameless mode

​
Window Always on Top

​
boolean
default:"false"
Keep ImageGlass window always on top of other windows

​
Window Fit Mode

​
boolean
default:"false"
Automatically resize window to fit the image
​
boolean
default:"true"
Center the window when Window Fit mode is enabled

​
Frame Navigation Tool

​
boolean
default:"false"
Show frame navigation controls for multi-frame images (GIF, TIFF, etc.)

​
Color Hex Format

Color values use hex format with optional alpha channel:
  • RGB: "#RRGGBB" (e.g., "#ff0000" for red)
  • RGBA: "#RRGGBBAA" (e.g., "#ff0000ff" for opaque red)
  • Short RGB: "#RGB" (e.g., "#f00" for red)
  • Short RGBA: "#RGBA" (e.g., "#f00f" for opaque red)
Use 00 alpha for fully transparent, ff for fully opaque

​
Layout Configuration

​
object
default:"{}"
Advanced layout configuration for toolbar and gallery positioningStructure: { "ControlName": "DockStyle;order" }This is typically managed through the Settings UI.

​
Applying Changes

1

Edit Configuration

Modify igconfig.json with your preferred settings
2

Save File

Ensure the JSON is valid before saving
3

Restart ImageGlass

Changes take effect on next launch (some settings apply immediately)
Invalid color hex codes will be ignored and default to theme colors

​
See Also

Themes

Install and create custom theme packs

Advanced Configs

Explore hidden appearance options