SpinForge AI — Troubleshooting

FFmpeg not found

If FFmpeg is not installed or not on your PATH, SpinForge AI automatically falls back to an OpenCV encoder. For production-quality MP4 output, install FFmpeg and verify with:

ffmpeg -version

See Installation for per-OS setup.

Output looks flat / not truly 3D

This is expected. SpinForge AI generates clean 2D 360-style motion loops from a single flat image. True 3D side and back views require multi-angle photography or a 3D-model workflow.

Background removal artifacts

Background removal via rembg works best on images with a clear subject and reasonable contrast. If results are imperfect, try disabling background removal (the full image is then centered on your chosen background color).

Upload rejected

Uploads are validated for type and size. Use a JPG, PNG, JPEG, or WEBP image and ensure it is within the configured size limit.

Permission / write errors in production

Ensure uploads/, outputs/, outputs/frames/, and data/ exist and are writable by the application process.