Tutorial

1. Getting Started

Installation

1. Go to the GitHub Releases page and download the latest installer.
2. Run the installer and follow the on-screen instructions.
3. Once installed, you can launch WobblePic from the desktop shortcut or Start Menu.

Opening Images

There are several ways to open images in WobblePic:

• Right-click an image file in Windows Explorer → "Open with" → WobblePic
• Drag and drop an image file or folder onto the WobblePic window
• Launch directly — WobblePic opens your Pictures folder by default

WobblePic main window with file explorer panel and image viewer

2. Basic Controls

Wobble!

Click and drag anywhere on the image. The surface stretches like skin, following your mouse. Release the mouse button and watch it bounce back with spring physics and inertia.

Navigate Images

• Left/Right Arrow or Space/Backspace — Previous/Next image
• Adjacent images are preloaded in the background for instant switching.

Zoom & Pan

• Mouse Wheel or +/- keys — Zoom in/out (up to 10x, centered on mouse position)
• Space + Drag or Middle Mouse Drag — Pan the image
• Arrow keys while zoomed — Pan the image

Rotate & Delete

• R or Shift+L — Rotate 90° clockwise
• L or Shift+R — Rotate 90° counter-clockwise
• Delete — Move current image to Recycle Bin (with confirmation)

Image Info

Press Tab to toggle the image info overlay, which shows the filename, resolution, format, and file size.

3. AI Segmentation

WobblePic uses SAM2 (Segment Anything Model 2) to automatically detect objects in your image. Once segmented, only the selected area wobbles while the background stays fixed.

Select an Object

• Click on an object — SAM2 automatically detects and segments it (point prompt)
• Drag a rectangle around an object — Select by bounding box (box prompt)

The segmented area appears slightly brighter, while the background dims — so you can clearly see what's selected.

Refine the Selection

• Shift + Click/Drag — Add to the current segment
• Alt + Click/Drag — Remove from the current segment
• Ctrl + Click/Drag — Smart toggle (adds outside mask, removes inside mask)

Segment Zoom

Use Shift + Mouse Wheel or Ctrl + Mouse Wheel to zoom only the segmented area while keeping the background fixed. Great for inspecting details!

How It Works Behind the Scenes

• SAM2 model loads in the background — you can start viewing images immediately
• Image encoding runs in a separate worker process (~5 seconds), so it never blocks your interaction
• Decoding (segmentation) is instant (~50ms) when you click
• If encoding isn't finished yet, the entire image area wobbles (no segmentation)
• Adjacent images are pre-encoded for seamless switching

4. File Explorer Panel

The left side panel shows a file explorer with folders and image files in the current directory.

• Click a folder — Navigate into that folder
• Click ".." — Go up to the parent directory
• Click an image file — Switch to that image (current selection is highlighted)
• Each item displays its Windows system icon for easy identification

You can also drag and drop image files or folders from Windows Explorer directly into the WobblePic window to open them instantly.

5. Keyboard Shortcuts