Skip to main content

​
Overview

ImageGlass provides comprehensive mouse and touch gesture support for intuitive image navigation and manipulation.

​
Mouse Wheel Actions

The mouse wheel behavior can be customized based on modifier keys. These actions are fully configurable in Settings.
You can configure the mouse wheel to perform any of these actions:
  • Zoom - Zoom in/out
  • Pan Vertically - Scroll image up/down
  • Pan Horizontally - Scroll image left/right
  • Browse Images - Go to next/previous image
  • Do Nothing - Disable wheel action
Configure mouse wheel actions in Settings (Ctrl+,) under Mouse section.

​
Mouse Click Actions

Mouse clicks can trigger various actions. All click actions are customizable.

Default Click Actions

  • Left Double-Click - Toggle between Actual Size and Auto Zoom
  • Middle Click - Refresh current image
  • Right Click - Open context menu
  • X Button 1 (Back) - View previous image
  • X Button 2 (Forward) - View next image

Configurable Buttons

  • Left Click
  • Left Double-Click
  • Middle Click
  • Right Click
  • X Button 1 (Back)
  • X Button 2 (Forward)

​
Available Click Actions

You can assign any of these actions to mouse buttons:

​
Mouse Drag Actions

ImageGlass supports dragging to pan images that are zoomed in.

Image Panning

When an image is zoomed in beyond the window size:
  1. Click and hold the left mouse button on the image
  2. Drag the mouse to pan the image in any direction
  3. Release to stop panning
This works for both mouse and touchpad/trackpad devices.

​
Touch Gestures

Touch gestures are available on touch-enabled Windows devices.
Single-finger pan - Drag with one finger to pan the image
  • Supports both horizontal and vertical panning
  • Works with inertia for smooth scrolling
  • Pan continues briefly after lifting finger
1

Touch the image

Place one finger on the image
2

Drag to pan

Move your finger in any direction to pan
3

Release

Lift your finger - image continues moving with inertia
Two-finger pinch - Zoom in and out with pinch gesture
  • Pinch out (spread fingers apart) - Zoom in
  • Pinch in (bring fingers together) - Zoom out
  • Zoom center follows the midpoint between your fingers
1

Place two fingers

Touch the screen with two fingers
2

Pinch to zoom

Move fingers apart to zoom in, together to zoom out
3

Release

Lift fingers to finish zooming
Two-finger tap - Context menu (configurable)Quickly tap the screen with two fingers to trigger the assigned action.

​
Touch Gesture Configuration

Touch gestures are automatically enabled on compatible devices. The following gestures are supported:

​
Customizing Mouse Actions

To customize mouse and wheel actions:
1

Open Settings

Press Ctrl+, or click Settings in the menu
2

Navigate to Mouse section

Find the Mouse settings panel
3

Configure wheel actions

Select desired action for each modifier key combination:
  • Scroll (no modifier)
  • Ctrl + Scroll
  • Shift + Scroll
  • Alt + Scroll
4

Configure click actions

Assign actions to each mouse button:
  • Left Click / Double-Click
  • Middle Click
  • Right Click
  • X Buttons (side buttons)
5

Save changes

Click Save or Apply to use your new configuration

​
Tips & Best Practices

For Mouse Users

  • Use wheel for quick zooming at cursor position
  • Assign frequently-used actions to side buttons
  • Keep right-click for context menu access
  • Use Ctrl+Wheel for precise vertical panning

For Touch Users

  • Single-finger pan for navigation
  • Pinch gestures for natural zooming
  • Two-finger tap for quick menu access
  • Swipe gestures work in gallery mode
Experiment with different configurations to find what works best for your workflow. You can always reset to defaults in the Settings panel.

​
Advanced: Toggle Actions

Some actions support “toggle” behavior, allowing you to assign different actions based on the current state:
For example, you can configure a button to:
  • When toolbar is hidden: Show toolbar
  • When toolbar is visible: Hide toolbar
This allows a single button/gesture to act as a toggle switch for various features.
Touch gestures require Windows 7 or later with touch-enabled hardware. Some gestures may not work in WebView2 mode (used for SVG rendering).

Build docs developers (and LLMs) love

Get started for freeTalk to us