Skip to main content

​
Image Booster Cache

Image Booster pre-loads adjacent images in memory for instant navigation. Configure these settings to balance performance and memory usage.

​
Cache Count

​
ImageBoosterCacheCount
number
default:"1"
Number of images to cache in each direction (previous/next)Range: 0-10 imagesMemory Impact:
  • 0 - No pre-loading, minimal memory usage
  • 1 - Caches 1 image before and 1 after (default)
  • 5 - Caches 5 images in each direction (high memory)
Example: "ImageBoosterCacheCount": 2
With ImageBoosterCacheCount: 2, ImageGlass caches 5 images total: 2 before, current, and 2 after

​
Cache Dimension Limit

​
ImageBoosterCacheMaxDimension
number
default:"8000"
Maximum image dimension (width or height) to cache in pixelsImages larger than this dimension won’t be pre-cached to save memory.Special Values:
  • 0 or negative - No dimension limit (cache all sizes)
  • Positive number - Maximum dimension in pixels
Example: "ImageBoosterCacheMaxDimension": 4000

​
Cache File Size Limit

​
ImageBoosterCacheMaxFileSizeInMb
number
default:"100.0"
Maximum file size to cache in megabytesFiles larger than this won’t be pre-cached to save memory and loading time.Special Values:
  • 0 or negative - No file size limit
  • Positive number - Maximum file size in MB
Example: "ImageBoosterCacheMaxFileSizeInMb": 50.0
Recommended for 16GB RAM: ImageBoosterCacheCount: 2, MaxDimension: 8000, MaxFileSize: 100Recommended for 8GB RAM: ImageBoosterCacheCount: 1, MaxDimension: 4000, MaxFileSize: 50

​
Thumbnail Cache Size

​
GalleryCacheSizeInMb
number
default:"400"
Maximum size of persistent thumbnail cache in megabytesThumbnails are cached to disk for faster gallery loading on subsequent views.Recommended Values:
  • Small collections (< 1000 images): 200 MB
  • Medium collections (1000-5000 images): 400 MB
  • Large collections (> 5000 images): 800 MB
Example: "GalleryCacheSizeInMb": 800
​
ThumbnailSize
number
default:"50"
Thumbnail dimension in pixels (affects memory usage)Minimum: 20 pixelsLarger thumbnails look better but use more memory and cache space.

​
Image Loading

​
Async Loading

​
EnableImageAsyncLoading
boolean
default:"true"
Load images asynchronously for better UI responsiveness
Disabling may cause UI freezing with large images
​
ShowImagePreview
boolean
default:"true"
Display low-resolution preview while loading full imageImproves perceived performance for large files.

​
WIC Decoder Threshold

​
MinDimensionToUseWIC
number
default:"16000"
Minimum image dimension to use Windows Imaging Component (WIC) decoderWIC is optimized for very large images. Images with width or height >= this value will use WIC if the format is supported.Special Values:
  • 0 - Always use WIC when available
  • High value (e.g., 100000) - Rarely use WIC
Example: "MinDimensionToUseWIC": 8000

​
Embedded Thumbnails

Many RAW and other formats contain embedded thumbnails. Using these can dramatically speed up initial display.

​
RAW Formats

​
UseEmbeddedThumbnailRawFormats
boolean
default:"false"
Use embedded thumbnail for RAW formats instead of full imagePros: Much faster loadingCons: Lower quality, limited to thumbnail size

​
Other Formats

​
UseEmbeddedThumbnailOtherFormats
boolean
default:"false"
Use embedded thumbnail for non-RAW formats (JPEG, TIFF, etc.)Enable this for faster browsing of large photo libraries.

​
Thumbnail Size Threshold

​
EmbeddedThumbnailMinWidth
number
default:"0"
Minimum width of embedded thumbnail to useSpecial Values:
  • 0 - Accept any thumbnail size
  • Positive number - Minimum width in pixels
​
EmbeddedThumbnailMinHeight
number
default:"0"
Minimum height of embedded thumbnail to usePrevents using very small thumbnails that would look pixelated.
Fast RAW browsing: Enable UseEmbeddedThumbnailRawFormats with MinWidth: 1920, MinHeight: 1080

​
File Monitoring

​
EnableRealTimeFileUpdate
boolean
default:"true"
Monitor file system for changes and auto-updateDisabling can reduce CPU usage when viewing network drives.
​
ShouldAutoOpenNewAddedImage
boolean
default:"false"
Automatically open newly added images in the viewing folderUseful when monitoring a folder for new photos.

​
Image Loading Order

​
ImageLoadingOrder
string
default:"Name"
Sort order for images in the listOptions:
  • "Name" - Alphabetical by filename
  • "Random" - Random order
  • "FileSize" - By file size
  • "Extension" - By file extension
  • "DateCreated" - By creation date
  • "DateModified" - By modification date
  • "DateAccessed" - By access date
  • "ExifDateTaken" - By EXIF date taken
  • "ExifRating" - By EXIF rating
​
ImageLoadingOrderType
string
default:"Asc"
Sort directionOptions:
  • "Asc" - Ascending
  • "Desc" - Descending
​
ShouldUseExplorerSortOrder
boolean
default:"true"
Use Windows File Explorer sort order when possibleEnsures consistency with File Explorer.

​
Advanced Loading Options

​
EnableRecursiveLoading
boolean
default:"false"
Load images from subfolders recursively
Can be slow with deeply nested folder structures
​
ShouldGroupImagesByDirectory
boolean
default:"false"
Group images by directory when using recursive loading
​
ShouldLoadHiddenImages
boolean
default:"false"
Include hidden files in the image list

​
Format-Specific Settings

​
SVG Rendering

​
UseWebview2ForSvg
boolean
default:"true"
Use Microsoft Edge WebView2 for rendering SVG filesRequires: WebView2 Runtime installedProvides better SVG rendering quality and compatibility.

​
Multi-Frame Images

​
SingleFrameFormats
array
File formats to load only the first framePrevents accidentally loading all frames from large multi-layer files.Example: "SingleFrameFormats": [".avif", ".psd", ".tiff"]

​
Performance Monitoring

​
EnableDebug
boolean
default:"false"
Enable debug mode for performance loggingOutputs detailed loading and caching information to help diagnose performance issues.
Only enable for troubleshooting - may impact performance

​
Performance Profiles

​
Maximum Performance (High Memory)

{
  "ImageBoosterCacheCount": 5,
  "ImageBoosterCacheMaxDimension": 0,
  "ImageBoosterCacheMaxFileSizeInMb": 0,
  "GalleryCacheSizeInMb": 1000,
  "EnableImageAsyncLoading": true,
  "ShowImagePreview": true
}

{
  "ImageBoosterCacheCount": 1,
  "ImageBoosterCacheMaxDimension": 8000,
  "ImageBoosterCacheMaxFileSizeInMb": 100,
  "GalleryCacheSizeInMb": 400,
  "EnableImageAsyncLoading": true,
  "ShowImagePreview": true
}

​
Low Memory

{
  "ImageBoosterCacheCount": 0,
  "ImageBoosterCacheMaxDimension": 4000,
  "ImageBoosterCacheMaxFileSizeInMb": 50,
  "GalleryCacheSizeInMb": 100,
  "EnableImageAsyncLoading": true,
  "ShowImagePreview": false
}

​
See Also

Advanced Configs

Additional performance tweaks

Settings Overview

Configuration basics

Build docs developers (and LLMs) love

Get started for freeTalk to us