Frequently Asked Questions
Compression & Loading
Compression does not work?
Run Tool Diagnostics (Settings page → Tool Diagnostics → Run Diagnostics) to troubleshoot quickly. See Troubleshooting for details.
Common causes: missing VC++ runtime, antivirus blocking, or corrupted tool files.
The model fails to load after compression?
See Compression Optimization → Loading Compressed Models in Your Project for complete loader code covering Draco, Meshopt and KTX2.
Babylon.js and model-viewer have built-in Draco support — no extra configuration needed.
"The file is already Draco-compressed and cannot be compressed again"?
Draco does not support re-compressing compressed files. Use the original uncompressed file exported from your modeling software.
The compressed file is larger than the original?
Common with very simple models (< 1000 faces) or very small files (< 100KB), where metadata overhead exceeds the savings. Try a lower compression level or skip compression.
The model is deformed or shows artifacts after compression?
Quantization precision is too low. Lower the compression level (e.g., 9 → 7), or increase the position precision qp in advanced parameters (Draco only).
KTX2 texture fails to load?
You need to configure KTX2Loader — see Compression Optimization → Loading Configuration. If the target environment does not support KTX2, switch to JPEG or WebP in the texture settings.
Format Conversion
Materials are wrong after FBX conversion?
Complex FBX material graphs may be lost during conversion. We recommend opening the model in Blender and exporting GLB/glTF directly.
Do I still need to keep external textures after converting glTF to GLB?
No. GLB embeds all textures and is a fully self-contained single file.
Is there a recommended order for conversion and compression?
Yes: convert first (FBX → GLB), then compress (GLB → compressed GLB).
Licensing
What are the free tier limits and how do I remove them?
The free tier is available forever — only limited to 50MB per file (1MB textures) and batches of 5. Viewer, screenshots, logs and other features are unlimited.
To remove the limits, purchase a license — see Licensing & Pricing: Desktop from ¥45 (half-year), Team from ¥49.9/month.
Do you offer compression-as-a-service?
Yes. Send us your model and we will compress it for you, ¥50 per model, with before/after comparison data. Email 2632622425@qq.com to send your model.
Does my license survive a system reinstall?
No. Licenses are bound to one machine with a unique key. After a reinstall or hardware change, the old key becomes invalid and a new license is required. We recommend purchasing only after confirming your device setup.
Can a license be used on multiple computers?
No, each device requires a separate license.
Other
Does batch processing overwrite original files?
No. Files get an _optimized suffix by default; if the suffix is empty, an _1 counter is appended to prevent overwrites.
What format are video recordings in?
WebM (VP9). To convert to MP4: ffmpeg -i recording.webm -c:v libx264 output.mp4
Is macOS supported?
Yes — Windows 10/11 (64-bit), Linux (Ubuntu 20.04+, Fedora 36+, Debian 11+, RedHat 8+) and macOS (10.15+, Apple Silicon / Intel). Download Zipoly.app.zip, unzip and run — right-click to open on first launch.
Still have questions?
Email us at 2632622425@qq.com, or visit zipoly.raychart.cn.