Theme Configuration
ImageGlass supports separate themes for light and dark modes, allowing seamless transitions based on your Windows system theme.Theme Selection
Theme pack name to use when Windows is in dark modeExample:
"DarkTheme": "Kobe"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
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)
"BackgroundColor": "#2b2b2b"Display checkerboard pattern for transparent images
Limit checkerboard to image bounds only (not full viewer)
Slideshow Background
Background color for slideshow modeExample:
"SlideshowBackgroundColor": "#000000"Window Appearance
Window Backdrop
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
Display ImageGlass icon in the title bar
Toolbar Appearance
Toolbar Layout
Show/hide the main toolbar on startup
Center toolbar buttons horizontally
Height of toolbar icons in pixelsRange: 16-48 pixelsExample:
"ToolbarIconHeight": 32Automatically hide toolbar in fullscreen mode
Gallery Appearance
Gallery Display
Show/hide the thumbnail gallery panel
Display scrollbars in the gallery panel
Show filename below thumbnails
Thumbnail size in pixelsMinimum: 20 pixelsExample:
"ThumbnailSize": 70Number of thumbnail columns in vertical gallery layoutMinimum: 1 column
Auto-hide gallery in fullscreen mode
Navigation Buttons
Show left/right arrow navigation buttons on the viewer
Welcome Image
Display welcome image when no image is loaded
Fullscreen & Special Modes
Frameless Mode
Enable frameless window mode (no title bar or borders)
Hold Shift key to move the window in frameless mode
Window Always on Top
Keep ImageGlass window always on top of other windows
Window Fit Mode
Automatically resize window to fit the image
Center the window when Window Fit mode is enabled
Frame Navigation Tool
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)
Layout Configuration
Advanced layout configuration for toolbar and gallery positioningStructure:
{ "ControlName": "DockStyle;order" }This is typically managed through the Settings UI.Applying Changes
See Also
Themes
Install and create custom theme packs
Advanced Configs
Explore hidden appearance options