Skip to content

9. Troubleshooting

Jump to bottom
Lucas edited this page May 8, 2026 · 1 revision

Troubleshooting

macOS says the app is damaged or cannot be opened

Current GitHub builds may be unsigned.

After moving the app to Applications, run:

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

Then open Image MetaHub again.

My folder opens but no files appear

Check:

  • The folder contains supported media files.
  • Recursive subfolder scanning is enabled if files are inside nested folders.
  • The folder was not excluded.
  • Indexing has finished.
  • Filters/search are not hiding results.
  • Safe Mode is not hiding expected content.

Try clearing active filters or refreshing the folder.

Images appear but metadata is missing

Metadata depends on what the generator saved into the file.

Try:

  • Open the raw metadata panel.
  • Use Reparse Metadata on the selected image.
  • Check whether the file was exported through a tool that stripped metadata.
  • For ComfyUI, install the MetaHub Save Node for future generations.
  • For JPEG/WebP, confirm the metadata was not removed during conversion.

ComfyUI does not connect

Check:

  • ComfyUI is running.
  • The URL in Settings → Integrations is correct.
  • The default ComfyUI URL is usually http://127.0.0.1:8188.
  • The same URL opens in a normal browser.
  • The embedded workspace can be opened externally.
  • Restart ComfyUI and test the connection again.

Automatic1111 does not connect

Check:

  • A1111 was started with --api.
  • The URL in Settings → Integrations is correct.
  • The default A1111 URL is usually http://127.0.0.1:7860.
  • The same URL opens in a browser.
  • If using a dev/browser build, CORS may need:
--cors-allow-origins=http://localhost:5173

The app feels slow with a large library

Try:

  • Let indexing fully finish.
  • Avoid unnecessary strict startup verification for huge folders.
  • Use cache/background reconciliation.
  • Use search and filters before opening huge result sets.
  • Disable table thumbnails for very large result sets if needed.
  • Keep very large libraries split into sensible root folders.

Version 0.16.0 includes memory and cache reconciliation improvements for large ComfyUI libraries.

Videos do not display correctly

Try:

  • Reopen the viewer.
  • Refresh or reparse the file.
  • Confirm the file format is supported.
  • Check whether the codec is playable by your system/Electron.
  • For metadata, install or enable ffprobe when applicable.

Audio indexes but does not play

Audio metadata can be indexed even when Chromium/Electron cannot play the codec.

If playback fails, the file may still appear in the library with metadata.

Thumbnails look stale after replacing files

Try:

  • Refresh the folder.
  • Reparse metadata.
  • Restart the app if the file was overwritten externally.
  • Confirm the file path and extension did not change unexpectedly.

Smart Library clusters disappeared

Regenerate clusters from Smart Library.

Version 0.16.0 includes fixes for cached Smart Library cluster persistence across sessions.

The changelog splash appears repeatedly

Version 0.16.0 includes a fix for the What's New screen reopening after the current version was already viewed.

If it still happens, check that settings are being saved correctly.

Clone this wiki locally