⚠️ Known Issues

Last updated: May 2025

This page documents current bugs, technical limitations, and known quirks in the Visual Theremin project.
Please check here before submitting a new issue or troubleshooting unexpected behavior.

---

🧪 System / Performance

• Camera Lag

Symptoms: video feed stutters or lags in TouchDesigner (most common after removing hands from frame).
Cause: No frame data latching to hold variables, math OPs can be optimized.
Workarounds:

• Try reducing resolution of the video input
• Force CPU decoding instead of GPU via TOP settings

---

• Audio Artifacts

Symptoms: Popping, distortion, or dropped audio in Max/MSP.
Cause: Potentially due to poor optimization in TouchDesigner..
Solution: Need more research on specifics of optimization around OSC between apps

• Align both apps to the same sample rate via system audio settings
• Add a sample rate check script in Max (planned)

---

🛠 TouchDesigner

---

🎛 Max/MSP

---

📷 Hardware

---

🧭 Planned Fixes (Upcoming Versions)

• Auto-detection of sample rate and OSC ports on startup
• Streamlined setup wizard for first-time users

---

Found something that’s not listed here?
Open an issue →

---