Troubleshooting

When compression or conversion misbehaves, first click Run Diagnostics under Settings → Tool Diagnostics, then match the results against the solutions below.

Missing Visual C++ Runtime (most common)

Symptoms: diagnostics show ✗ Cannot execute, or a "VCRUNTIME140.dll not found" error.

Cause: Windows is missing the Microsoft Visual C++ 2015-2022 Redistributable (x64), a required component of the compression engines. 90% of compression failures are caused by this.

Fix:

1. Download the VC++ runtime
2. After installing, reopen Zipoly (no system restart needed)

Tool Files Missing or Corrupted

Symptoms: ✗ Executable not found or ⚠ No response.

Fix: Reinstall Zipoly. Don't download draco_transcoder.exe or gltfpack.exe separately to replace them — version mismatches may occur.

Blocked by Antivirus

Symptoms: diagnostics show ✗ Cannot execute even though the VC++ runtime is installed.

Fix: Add the Zipoly install directory (C:\Program Files\Zipoly\) to your antivirus whitelist/exclusion list.

Missing Linux Dependencies

Symptoms: Zipoly fails to start or features are unavailable on Linux.

Fix:

# Ubuntu / Debian
sudo apt-get install libwebkit2gtk-4.1-0 libgtk-3-0

# Fedora / RedHat
sudo dnf install webkit2gtk4.1 gtk3

macOS Gatekeeper Block

Symptoms: macOS shows "cannot verify the developer" or "damaged and cannot be opened" on first launch.

Cause: macOS Gatekeeper blocks unsigned/unnotarized apps by default.

Fix: Right-click Zipoly.app → choose Open (or go to System Settings → Privacy & Security → Open Anyway). Code signing and notarization are planned for a future release.

Advanced Troubleshooting

View detailed logs

In the diagnostics window, click "View Raw Output" → "Copy Result" and send the report to support.

Verify the tools manually

cd "C:\Program Files\Zipoly"
draco_transcoder.exe

You should see usage help (Usage: ...). If it reports VCRUNTIME140.dll, the VC++ runtime is missing.

Technical Support

If none of the above helps, email 2632622425@qq.com with the following to speed up the diagnosis:

1. The diagnostics report (get it via "Copy Result")
2. System version (Win + R → winver)
3. Zipoly version (top of the Settings page)