Use -movflags +faststart and yuv420p for broad player compatibility.

SFM Compile – Troubleshooting Guide

TL;DR – Quick Triage

Verify paths: project/content/output folders exist; no non‑ASCII/path length issues.
Clear temp/cache; kill stale processes; re‑open project.
Check codecs/tools: FFmpeg available; correct encoders; test a short sample.
Analyze logs below; apply suggested fixes; retry minimal scene first.

Error Analyzer

Paste compile/export logs. We highlight patterns and propose fixes (local only).

Common Issues & Fixes

File/Path

No such file or directory → Check path, quotes, permissions; try a short ASCII path.
Access denied → Close viewer, run as user with write rights, unblock file.
Path too long → Shorten project root; avoid deep nesting.

Codecs/FFmpeg

Unknown encoder → List encoders: ffmpeg -hide_banner -encoders; switch to libx264/aac.
Muxer not found → Ensure -f mp4 and extension match; add -movflags +faststart.
Pixel format mismatch → Use -pix_fmt yuv420p for compatibility.

Performance/Memory

Render to image sequence first (PNG), then encode via FFmpeg.
Lower resolution/bitrate to isolate bottlenecks.
Close other apps; ensure enough disk space.

Project Integrity

Missing assets → Re‑import or correct search paths.
Corrupt cache → Delete temp/output; rebuild.
Version drift → Pin tool versions; document presets.

Recommended Pipeline

Export PNG sequence to out/frames/%06d.png.

Encode with FFmpeg:

ffmpeg -r 30 -i out/frames/%06d.png -c:v libx264 -profile:v high -crf 18 -pix_fmt yuv420p -movflags +faststart out/final_1080p.mp4
ffmpeg -i out/final_1080p.mp4 -c:v libx264 -vf scale=1280:-2 -crf 20 out/final_720p.mp4

Audio: export WAV separately, then mux:

ffmpeg -i out/final_1080p.mp4 -i out/audio.wav -c:v copy -c:a aac -b:a 192k out/final_with_audio.mp4

Tip: keep a preset.json with resolution, fps, CRF, and pixel format for reproducibility.

Script Builder (Bash / PowerShell)

Resolution

CRF

FPS

Pixel Format

Faststart (MP4)

Output name

Toolkit ZIP 包含：bash/ps1 脚本、preset.json、checklist.md。

Recommended Tools (Affiliates)

Cloud CI/CD for Devs – fast pipelines with generous free tier.
App Logging & Monitoring – track crashes and performance.
Developer‑friendly VPS – preinstalled FFmpeg images.

Links may be affiliate. Choose providers you trust.

Checklist (Copy‑ready)

[ ] Project paths valid (ASCII, short, writable)
[ ] Temp/cache cleared; fresh start
[ ] Export PNG sequence OK
[ ] FFmpeg present; encoders list checked
[ ] H.264 + yuv420p + faststart
[ ] Audio WAV muxed OK
[ ] Disk space > 10 GB
[ ] Preset.json updated; versions noted

FAQ

Why PNG sequence first?

It isolates render from encoding and avoids partial corruption; retries are cheaper.

Which CRF should I use?

Start with 18–20 for 1080p; lower is higher quality/larger size.

Export is fine but playback stutters.

Ensure -movflags +faststart, and use yuv420p pixel format.