Docs · Questions
StreamDiffusionTDUsage
How did StreamDiffusionTD handle video output in early versions? What happened to NDI and Spout?
StreamDiffusionTD Video Output Evolution - NDI/Spout to Shared Memory
⚠️ LEGACY INFORMATION - Only relevant for v0.1.0 through v0.1.7 (January 2024 - April 2024)
Historical Context (OLD VERSIONS)
v0.1.0 - v0.1.7 (Jan 21 - Apr 11, 2024): NDI + Spout
Early StreamDiffusionTD versions used NDI (Network Device Interface) and Spout for video transfer between the Python backend and TouchDesigner.
Performance Characteristics:
- NDI: Capped at 30-33 FPS, network-based (worked remotely)
- Spout: Up to 180 FPS, GPU-direct (local only, faster but impacted GPU load)
Known Issues:
- v0.1.0 Memory Leak: NDI implementation had memory buildup issue
- v0.1.1 Fix (Jan 15, 2024): Memory leak resolved
- GPU Overhead: Spout added significant GPU load during diffusion
⚠️ DEPRECATED (April 21, 2024)
v0.1.8+ (Apr 21, 2024 onwards): Direct Shared Memory Buffer
Complete replacement - NDI and Spout were removed entirely and replaced with direct shared memory buffer.
Benefits of New Method:
- Lower latency - no video encode/decode overhead
- Higher FPS - no artificial caps
- Improved diffusion quality - better input image coherence
- Local only - works on single machine (non-local support planned for future)
If You’re Using Modern Versions
You don’t need to know any of this. The shared memory system is automatic and invisible.
If You’re Stuck on v0.1.0-v0.1.7
Recommendation: Update to v0.1.8 or later (or v0.2.0+ for major improvements).
If you must stay on old versions:
- Use Spout for best local performance (if GPU isn’t maxed)
- Use NDI only if you need remote streaming
- Ensure you’re on v0.1.1+ to avoid memory leak
Migration Notes
No migration needed - updating the TOX automatically switches to the new system. Just:
- Download new TOX version
- Set Basefolder parameter to your existing StreamDiffusion installation folder
- Start stream as normal
Timeline:
- v0.1.0 (Jan 11, 2024): Initial release with NDI + Spout
- v0.1.1 (Jan 15, 2024): Fixed NDI memory leak
- v0.1.8 (Apr 21, 2024): DEPRECATED - Replaced with shared memory buffer
- v0.2.0+ (Aug 2024+): Shared memory standard, mature implementation
Current Status (Nov 2025): NDI/Spout method has been deprecated for 19 months. All modern versions use shared memory exclusively.