🟣 Breaking changes

• Changed default hotkey for:
  • Gallery (from H to G)
  • Go to (from G to F)
• Renamed setting AllFormats to FileFormats, SinglePageFormats to SingleFrameFormats
  • Remove the wildcard from the format
    • Before: "AllFormats": "*.jpg;*.png"
    • After: "FileFormats": ".jpg;.png"
    • This also applies for commands igcmd.exe set-default-viewer <formats> and igcmd.exe remove-default-viewer <formats>
• Renamed setting ToolbarItems to ToolbarButtons
• Renamed setting InfoItems to ImageInfoTags
• Renamed the Arguments of Tools setting to Argument
• Changed the Arguments type of MouseClickActions, ToolbarButtons from string to string[] (string array)
• Moved theme setting ShowTitlebarLogo to app setting ShowAppLogo

🟣 General changes

• Upgraded Magick.NET to version 13.3.0
• Added support for .NET 8, ARM64 (experiment #1000) build
• Added new Color dialog that supports picking alpha value
• Added feature: File > New window
• Add setting DisabledMenus to disable menus of ImageGlass similar to v8
• Add setting EnableDebug to launch ImageGlass in debug mode
• Added .jxl into the list of non-animated formats by default, you can change it in the setting SingleFrameFormats
• Added default actions for mouse clicks similar to v8
• Added icon for toolbar button "Exit" (#1659 thanks to @xmha97)
• Fixed a vulnerability occurring with WebP files (CVE-2023-4863) (#1655)
• Fixed an issue where some formats are displayed with wrong orientation #1619
• Fixed an issue where mouse click action is not executed when the ToggleOff is empty
• Fixed an issue where Toolbar and Gallery background color are also updated when Backdrop style is None
• Fixed an issue where the Exiting Full screen mode does not restore the previous window modes (Frameless, Window fit)
• Fixed an issue where resetting the background in Settings > Appearance does not follow current theme background
• Fixed an issue where app settings UI does not load due to incorrect path of Icons folder (#1630)
• Fixed an issue when passing method name begins with IG_ causes error "Parameter count mismatch"
• Fixed an issue where setting IsIntegrated = false cause the 2nd instance of external tool cannot be launched
• Fixed an issue where pressing Alt+F4 does not close the window
• Fixed an issue where ImageGlass cannot open some images (#1622)

🟣 Quick Setup dialog

• A new Out-of-box experience wizard that replaces First-launch configurations of v8
• Added 2 setting profiles: Standard user and Professional user
• Added setting QuickSetupVersion, set a value greater than 9 will prevent the Quick Setup dialog from showing.

🟣 App Settings

• Added new setting ShowAppIcon to toggle the ImageGlass icon on the title bar
• Added UI for setting ImageInfoTags
• Added UI for setting EditApps:
  • Allows to assign the editing app for multiple extensions:

    // in igconfig.json
    "EditApps": {
      // open .JPG and .PNG file with Photoshop
      ".jpg;.png": {
        "AppName": "Photoshop",
        "Executable": "path\\to\\photoshop.exe",
        "Argument": "<file>" // <file> is the current image path to pass to the 'Executable'
      }
    }
    

• Added UI for setting ToolbarButtons:
  • Supports drag and drop to arrange the order of the buttons
  • Supports drag and drop to add a button
  • Adds "Reset to default" button
  • Adds and edits custom toolbar button in JSON format
  • Adds action buttons to move up/down, edit, delete the toolbar button
    • Only the custom toolbar button is editable
• Added UI for File type associations setting:
  • Adds information for changing File extension icons
  • Adds information for Set/Remove default photo viewer
  • Adds UI for setting FileFormats
• Added a "Get help" floating button for quickly accessing documentation
• Improved UI for setting ZoomLevels:
  • Adds a checkbox Use smooth zooming
  • Adds a link button Load default zoom levels
• Removed "ImageGlass" on the file type when registering it as the default photo viewer (#833)

🟣 Viewer component

• Displays more details on the viewer when ImageGlass cannot open image file

🟣 Gallery component

• Fixed an issue where thumbnail cache is always reset (#1647)
• Fixed an issue where thumbnail cache size limit does not follow setting GalleryCacheSizeInMb (#1647)

🟣 ImageGlass Tools

• Changed the tool config Arguments to Argument:

  // in igconfig.json
  "Tools": [
    {
      "ToolId": "Tool_MyDemoApp", // a unique ID
      "ToolName": "My Demo app", // name of the tool
      "Executable": "path\\to\\the\\DemoApp.exe",
      "Argument": "<file>", // <file> is the current image path to pass to the 'Executable'
      "Hotkeys": ["X", "Ctrl+E"], // press X or Ctrl+E to toggle the tool
      "IsIntegrated": true|false // true: if the tool supports 'ImageGlass.Tools'
    }
  ]
  

🟣 Breaking changes

• Change app settings and app registry from per-machine to per-user:
  • App settings: Use %LocalAppData% folder (previouly, it was %AppData%) to save user setting file igconfig.json when ImageGlass does not have write permission in its startup folder
  • App registry: Use HKEY_CURRENT_USER (previously, it was HKEY_LOCAL_MACHINE) for registering file type associations, app protocol (#1581)
• Updated the argument naming of the settings ToolbarItems, Tools from Argument to Arguments.

🟣 General changes

• Upgraded Magick.NET to version 13.2.0
• Removed igcmd10.exe utility
• Added support for reading grayscale DNG images (#1575)
• Added support for showing file thumbnail when dragging from Windows to ImageGlass (.NET 7 build on Windows 11)
• Added new commands for igcmd.exe utility: install-languages, install-themes, uninstall-theme
• Improved DPI and text scaling for menu
• Improved the direction of the menu dropdown when it's open
• Improved keyboard parser with better accuracy (#1612)
• Improved the stability of Share dialog
• Added setting SlideshowImagesToNotifySound to let user determine the number of images to play notification sound in slideshow mode
• Fixed an issue where user could not start slideshow due to incorrect command line prefix
• Fixed an issue where the image is sometimes not displayed after a very quick navigation
• Fixed an issue where orientation of HEIC format is displayed wrong (#1551)
• Fixed an issue where NEF files appear darker with colors less saturated (#1577)
• Fixed an issue where ImageGlass displays NEF files in wrong orientation (#1478)
• Fixed an issue where ImageGlass could not display TIF files due to invalid tag 32932 (#1583) and tag 34031 (#1617)
• Fixed an issue when triggering custom hotkeys such as Alt and key causes windows error sound to play (#1613)

🟣 Add UI for App Settings

• Added support for changing user settings for:
  • Tab General
  • Tab Image
  • Tab Slideshow
  • Tab Edit: except for the EditApps setting
  • Tab Viewer
  • Tab Toolbar: except for the ToolbarItems setting
  • Tab Gallery
  • Tab Layout
  • Tab Mouse: except for the MouseClickActions setting
  • Tab Tools
  • Tab Language
  • Tab Appearance
• Resolved an issue where settings are hidden on high DPI screen (#793, #1266)
• Resolved an issue where emoji characters are not rendered in Settings window (#1220)
• Resolved an issue where user does not see the changes when pressing "Apply" button (#623)
• Resolved an issue where the Settings UI is reset when switching tabs (#482)

🟣 Viewer component

• Added support for touch guestures:
  • Supports zooming image by 2 fingers (#591, #739, #1611)
  • Supports panning image with inertia by 1 finger (#591)
  • Supports opening context menu by long tap
• Added support for custom zoom levels via setting ZoomLevels (#1563).

🟢 Added a new Webview2 viewer component using HapplaJs library

• Supports scaling SVG (#421), animated SVG (#1098), interactive SVG files
• Supports opening image by dropping files from desktop
• Supports navigation arrow buttons according to the setting
• Supports showing in-app message
• Supports customizing MouseWheel action
• Supports customizing MouseClick action (right button)
• Supports zooming features:
  • All zoom modes
  • Zoom by hotkeys
  • Set custom zoom
  • Follow zoom levels setting
• Supports panning features:
  • Pan by hotkeys
  • Follow pan speed setting
• Other features may just work, except for Rotation, Flipping, Color picker, Cropping, Page navigation, Copy image data, Print, Set as Desktop/Lock screen, View image channels, Export image frames, ...
• Added an option to switch back to the native viewer component:
  • Open Settings > Viewer
  • Uncheck the option Use Webview2 for viewing SVG format (or set UseWebview2ForSvg to false in igconfig.json).
• When ImageGlass window is minimized, the Webview2 viewer component will be suspended to consume less memory similar to MS Edge's sleep mode.

🟣 Toolbar component

• Added support for adding external tool as toolbar button using the tool ID
• Improved Main menu position to make sure it does not cover the toolbar when the toolbar is at bottom
• Fixed an issue where user cannot use custom image path for toolbar icon (#1554)
• Fixed an issue where user cannot click the toolbar buttons when the window is inactive (#1202, #1363)
• Fixed an issue where tooltip overlaps the hovered button when the gallery's position is not on top

🟣 Gallery component:

• Added support scrolling thumbnails by swipe guesture (#753)
• Added support for resizing gallery by dragging the separator in vertical layout
• Added support for saving the last size of gallery component (#1502)
• Added support for displaying scrollbars with dark mode
• Improved gallery layout scaling according to system text size setting
• Improved click action to only allow to use the left mouse for image navigation
• Fixed an issue where the dragged thumbnail is still selected after mouse is released
• Fixed an issue where thumbnail's tooltip is still showing after leaving the thumbnail
• Fixed an issue where tooltip overlaps the hovered thumbnail when the gallery's position is not at bottom

🟣 Tooltip component

• Added supports for dark mode
• Added supports round corner on Windows 11
• Added supports for using accent color for tooltip title
• Improved tooltip size and text scaling according to system text size setting

🟣 ImageGlass Tools

• Added support for CIELAB color space for Color Picker tool (#1543)
• Added support for setting topmost state of tool window according to ImageGlass window
• Added support for assigning hotkeys for external tool in Tools section in igconfig.json file:

  // in igconfig.json
  "Tools": [
    {
      "ToolId": "Tool_MyDemoApp", // a unique ID
      "ToolName": "My Demo app", // name of the tool
      "Executable": "path\\to\\the\\DemoApp.exe",
      "Arguments": "<file>", // file path to pass to the tool
      "Hotkeys": ["X", "Ctrl+E"], // press X or Ctrl+E to open/close the tool
      "IsIntegrated": true|false // true: if the tool supports 'ImageGlass.Tools'
    }
  ]
  

• Improved the built-in tool window readability by increasing opacity to 95% (from 85%) in inactive state
• Fixed an issue where the second ImageGlass instance cannot open the external tool if other instances already open it

🟣 General changes

• Upgraded Magick.NET to version 13.0.1.
• Improved ImageGlass startup time and latency by enabling ReadyToRun compilation.
• Showed Color space and Color profile info on the title bar.
• Added basic support for animated APNG format (#396).
• Fixed a bug where ImageGlass cannot load image with CMYK color space. Error message: "Operation is not valid due to the state of the object".
• Fixed a bug that caused memory leak during loading image.
• Skipped file existence check while loading image files into the list (#585).
• Changed the prefix for passing app setting as command-line from - to /. Example: ImageGlass.exe /EnableFrameless=true.

🟣 Theme component

• Added support for auto-switching theme according to system's dark/light mode (#434).
  • Splits the setting Theme into DarkTheme and LightTheme.
  • Loads LightTheme if system light mode is on, otherwise ImageGlass uses DarkTheme.
• Removed accent color in theme config.
• Added new icons for toolbar: Play, Pause, Export.

🟣 Viewer component

• Improved frame animation (GIF, WEBP, ...)
  • Adds support for hardware acceleration.
  • Supports playing, pausing or viewing a single frame of image.
  • Adds basic support for playing animation for all animated formats using MagickNET, such as APNG.
• Made the navigation arrow buttons clickable on whole left and right areas (#1472).

🟣 Thumbnail bar component

• Shows Color space and Color profile info on the thumbnail's tooltip.

🟣 Image Booster component

• Reduced memory usage when loading non-transparent image.
• Enabled basic support for all animated formats using MagickNET.
• Cached metadata to improve loading image.

🟣 Features

• Added support for updating the viewing image folder in real time:
  • Updates the viewing image, thumbnail when it's changed by third-party app.
  • Updates the thumbnail bar when image file is deleted, added, renamed.
  • Added an option to disable it by setting: EnableFileWatcher.
• Added Edit image with external editor:
  • Added setting EditApps, example:

    // in igconfig.json
    "EditApps": {
      ".png": {
        "AppName": "Paint.NET",
        "Executable": "C:\\paint.net\\paintdotnet.exe",
        "Argument": "<file>"
      }
    },
    

  • Added options what to do after the external editor is launch AfterEditingAction:
    • Nothing: Do nothing (default).
    • Minimize: Minimize ImageGlass window.
    • Close: Close ImageGlass app.
• Added feature: Export image frames
  • Moves the function to igcmd.exe with command export-frames.
  • Shows exporting progress and status.
  • Added a button to cancel the on-going export progress.
  • Added a button to open output folder after the export is done.
• Added feature: Rotate image (only for non-animated format).
• Added image transformation features:
  • Supports image rotation.
  • Improves performance of image flipping / ratation by using hardware acceleration.
  • Shows asterisk * on title bar next to the image name to indicate there is unsaved change.
  • Displays "Save..." / "Save as..." button on toolbar if the image is changed.
• Adds native support for animated Webp format (#1466) using libwebp.dll v1.3.0:
  • Supports hardware acceleration.
  • Fixed: Quality of animated Webp is reduced (#1526).
  • Supports saving image as Webp, including animated format (#1477).
• Supports for saving TIFF, GIF as multiple frames.
• Improves ImageGlass Slideshow view:
  • Removed support for multiple slideshow views
  • Added support for changing slideshow image list when user changes it in the main view.
  • Made slideshow view togglable.
  • Added support for new window modes in slideshow view.

🟢 New window modes

• Frameless mode
  • The window corners are rounded by default.
  • Hold SHIFT and drag to move the window.
• Window fit mode
  • Disables Maximize button of the window.
  • Improve performance when user zooms the image.
  • Added support for all zoom modes in Window mode.
• Window modes combination for the main view and slideshow view:

  Mode	Full screen	Frameless	Window fit
  Full screen	✅	❌	❌
  Frameless	❌	✅	✅
  Window fit	❌	✅	✅

🟢 Layout customization

• Added support for layout customization using setting Layout (#318) for:
  • Toolbar with setting Toolbar,
  • Thumbnail bar with setting Gallery,
  • Contextual toolbar with setting ToolbarContext.
• Supports Toolbar position: Top, Bottom.
• Supports Thumbnail bar position: Top, Bottom, Left, Right.
• Allows to change control's order if they are in the same layout position.
• Example:
  • Default layout:

    // in igconfig.json
    {
      // default layout
      "Layout": {
        "Toolbar": "Top", // Toolbar is at top
        "Gallery": "Bottom;0", // thumbnail bar is at bottom
        "ToolbarContext": "Bottom;1", // contextual toolbar is at bottom, above thumbnail bar
      },
    }
    

  • Layout: toolbar and thumbnail bar at top, contextual toolbar at bottom

    // in igconfig.json
    {
      "Layout": {
        "Toolbar": "Top;1", // Toolbar is at top, below thumbnail bar
        "Gallery": "Top;0", // thumbnail bar is at top, above the toolbar
        "ToolbarContext": "Bottom", // contextual toolbar is at bottom
      }
    }
    

🟢 New Color picker tool

• Shows cursor location on the viewing image.
• Clicks to pick the pixel color.
• Adds support for color formats: RGB, HEX, CMYK, HSL, HSV.
• Adds buttons to copy color code.
• Adds Settings window with options to show alpha value for each color format.

🟢 New Page navigation tool

• Supports for viewing separate image frame.
  • Non-animated formats (TIFF, ICO,...).
  • Animated formats (GIF, WEBP, APNG,...).
• Respects the size and orientation of the image frame (#1077).
• Exports all frames.

🟢 External tools support

• You can download external tools at https://imageglass.org/tools.
• Created https://github.com/ImageGlass/ImageGlass.Tools library for other 3rd-party apps to communicate with ImageGlass via IPC message events.
• Sends events to the external tools using ImageGlassEvents.
• Sends EnableWindowTopMost as a command-line argument to request the external tool window to be top most.
• Uses ToolSettings setting to store settings of the built-in tools (Crop tool, Color picker) instead of Tools.
• Added support for adding external tools to ImageGlass Tools menu with setting Tools and assigning the tool's hotkeys with setting MenuHotkeys.
• Shows "Tool not found" dialog to allow user to select executable path of the tool.
• For more details, please refer to https://github.com/ImageGlass/ImageGlass.Tools.