FAQ

Frequently asked questions about WobblePic.

Installation & Setup

Is WobblePic free?

Yes! WobblePic is completely free to use for both personal and commercial purposes.

Which operating systems are supported?

Currently, WobblePic is available for Windows only. macOS, iOS, and Android versions are planned for the future.

What are the system requirements?

You need a GPU that supports OpenGL 3.3 or later (most GPUs from 2012 onwards) and at least 4GB of RAM. For AI Segmentation, an AMD, NVIDIA, or Intel GPU is required for hardware acceleration via ONNX Runtime + DirectML.

What image formats are supported?

WobblePic supports JPG, PNG, BMP, GIF, WebP, and TIFF formats.

Features

What is AI Segmentation?

AI Segmentation uses SAM2 (Segment Anything Model 2) to automatically detect objects in your image. Once an object is segmented, only that area wobbles while the background stays fixed — making the effect much more realistic and fun!

Can I use WobblePic without the SAM2 model?

Yes! Without SAM2, the entire image area will wobble when you drag it. Segmentation is optional — WobblePic works perfectly fine without it.

Do I need a GPU?

A GPU with OpenGL 3.3 support is required for the core wobble rendering. For AI Segmentation, a DirectML-compatible GPU (AMD, NVIDIA, or Intel) is needed for hardware acceleration. Without a compatible GPU, segmentation will fall back to CPU mode (slower but functional).

How does the physics simulation work?

WobblePic uses a mass-spring system to simulate soft-body physics. Your image is converted into a mesh of points connected by springs. When you drag the image, forces propagate through the mesh, creating realistic wobble, jiggle, and bounce effects. Read our tech deep dive for the full details.

Can I export or save the wobble animation?

Currently, WobblePic is focused on real-time interactive viewing — you can wobble images live but cannot export the animation as a video or GIF. Animation export is a feature we're considering for future versions.

What is the File Explorer panel?

The File Explorer is a built-in panel that lets you browse and open images from your folders without leaving WobblePic. You can navigate directories, preview images, and quickly switch between files — all from within the app. It also supports right-click context menus, inline rename, and clipboard (Cut/Copy/Paste) just like Windows Explorer.

What is the Pin feature?

While dragging, press Right-click or P to pin the deformation in place. The image stays stretched even after you release the mouse. You can pin up to 4 spots simultaneously and wobble other areas. Click a red dot to release a pin, or press ESC to release all.

Can I adjust the wobble physics?

Yes! Open the Settings panel (gear icon at top-right) to adjust Elasticity (how stretchy), Bounce (how bouncy), and Selection Range (segmentation sensitivity). Changes apply in real-time and are saved automatically.

Troubleshooting

The app won't start or the screen is black.

Make sure your GPU drivers are up to date. WobblePic requires OpenGL 3.3 support. If the problem persists, try running the app with the --verbose flag and check the log files in the logs/ directory for error details.

SAM2 model loading takes a long time.

The SAM2 model loads in the background when the app starts. This usually takes a few seconds depending on your hardware. You can start viewing and interacting with images immediately while the model loads — a "Loading SAM2 model..." overlay will disappear once it's ready.

My image won't open.

Make sure the file is in a supported format (JPG, PNG, BMP, GIF, WebP, or TIFF). If the file is corrupted or in an unsupported format, WobblePic will skip it.

The wobble effect is too slow or laggy.

Performance depends on your GPU and image size. Try these steps: (1) Make sure your GPU drivers are up to date, (2) Close other GPU-intensive applications, (3) Try with a smaller image first to confirm it's not a hardware limitation. WobblePic adjusts mesh resolution automatically based on available GPU power.

AI Segmentation doesn't detect my object correctly.

SAM2 works best with clearly defined objects that have distinct boundaries from the background. Try clicking on different parts of the object, or try a different image. Complex scenes with overlapping objects or low contrast boundaries can be challenging for the model.

General

Is the source code open source?

WobblePic is freeware but not open source. You can use it freely, but the source code is not publicly available. See the License page for details.

Are macOS or mobile versions available?

Not yet, but they are on the roadmap! macOS and iOS (Swift + Metal + Core ML) are planned first, followed by Android (Kotlin + OpenGL ES + ONNX Runtime).

Where can I report bugs or request features?

Please visit the GitHub Issues page to report bugs or suggest new features.

How does WobblePic compare to other image editors?

WobblePic isn't a traditional image editor — it's a physics-powered image viewer that lets you interactively wobble and jiggle pictures in real time. While tools like Photoshop or GIMP focus on editing pixels, WobblePic focuses on bringing images to life with soft-body physics simulation. It's a unique, fun way to interact with your photos.

Can I use WobblePic for commercial purposes?

Yes! WobblePic is free for both personal and commercial use. You can use it in presentations, social media content, educational materials, or any other commercial context. See the License page for full details.

How can I advertise in WobblePic?

If you're interested in placing an ad within the WobblePic app, please contact us at wobblepic@gmail.com.