Support

Support and troubleshooting

Get help, report bugs, find logs and collect the details needed to diagnose desktop issues.

Before reporting a bug

Version

Include the app version

Check the version shown in the app sidebar/header and include it in the report.

System

Include OS and install type

Windows/macOS/Linux, OS version, release build or development build, and where the library is stored.

Steps

Describe what triggered it

List the shortest path to reproduce the bug, including folder size and file types when relevant.

Where to find logs

These are the common diagnostic paths. Adjust if the app data directory differs on your system.

Windows

%APPDATA%\image-metahub\logs\process-events.log %APPDATA%\image-metahub\renderer-crashes.log

macOS

$HOME/Library/Application Support/Image MetaHub/logs/process-events.log $HOME/Library/Application Support/Image MetaHub/renderer-crashes.log

Useful report template

Image MetaHub version: OS and version: Install/build type: Library size: Media types involved: What happened: Steps to reproduce: Expected behavior: Logs attached: Screenshots/recording:

Common fixes

macOS quarantine

If macOS blocks unsigned builds after moving the app to Applications:

xattr -dr com.apple.quarantine "/Applications/Image MetaHub.app"

GPU / black screen test

If the interface turns black, try launching with GPU disabled to test whether it is a compositor/GPU issue.

IMH_DISABLE_GPU=1 open -a "Image MetaHub"

Still stuck?

Open an issue with version, OS, reproduction steps and logs.