Troubleshooting & FAQ

Cannot Find File / Failed to Open from Other Apps

Issue: You cannot locate your 3D model file in the file picker, or opening the file directly from another app (like Mail or a messaging app) fails.

Troubleshooting Steps:

1. Check File Extension: Ensure your file extension matches one of our Supported Formats (e.g., .glb, .obj, .fbx). iOS and Web file pickers might gray out or hide unsupported file types.
2. Save to Local Storage First: If opening directly from another app fails, try saving or downloading the file to your device's local storage (e.g., "On My iPhone" or the "Downloads" folder) first, then open our app and select the file manually.
3. Check Cloud Sync: If you are selecting a file from iCloud Drive or another cloud service, ensure the file is fully downloaded to your device before trying to open it.

App Crashes When Opening Large Files

Issue: The viewer crashes, freezes, or closes unexpectedly when loading a large 3D model.

Solution: Mobile devices and web browsers have strict memory limitations. An extremely large file will exhaust available RAM.

• Reduce Mesh/Polygons: Use 3D modeling software (like Blender, Maya, or online decimation tools) to reduce the polygon count of your mesh.
• Compress Textures: 4K or 8K textures consume massive amounts of memory. Compress your image textures (PNG/JPG) and scale them down to 2048x2048 or 1024x1024.
• Use GLB: Pack your optimized mesh and textures into a single .glb file, which is highly efficient for loading.

Textures Look Wrong or Are Missing

Issue: The model loads, but it appears completely white, black, or is missing its colored textures.

Solution:

• If you are using .obj or .fbx, ensure that the accompanying material file (.mtl) and all texture image files are in the exact same folder as the model file.
• When transferring to mobile, zip the entire folder containing the model and textures, and upload the .zip file.
• For the most reliable results, export your model as a .glb file, which embeds textures directly inside the file.