Come configuarare Strudel con visual studio ed un server locale Node.js

strudel_cc_setup_mac.md

🛠 Setup Strudel: Dal Terminale alla Focusrite

1. Clonazione e Preparazione (Il Server)

Il progetto si basa sul repository di uzu, che è una versione potenziata di Strudel.

• Sorgente: https://codeberg.org/uzu/strudel.git
• Workflow da Terminale:

cd ~/Documents
git clone https://codeberg.org/uzu/strudel.git
cd strudel
nvm use 24         # Assicura l'uso di Node v24
pnpm install       # Installa le dipendenze (circa 25 min su macchine datate)
pnpm run dev       # Avvia il server locale

• Output atteso: Il terminale deve mostrare Local: http://localhost:4322/ (o :4321).

2. Integrazione Visual Studio Code

Per trasformare VS Code in una stazione di live coding:

• Plugin: Installa Strudel VS (di cmillsdev).
• Configurazione JSON: Premi Cmd + Shift + P -> Preferences: Open User Settings (JSON) e aggiungi:

"strudel.serverUrl": "http://localhost:4322",
"strudel.oscPort": 57120,
"files.associations": { "*.js": "strudel" }

• Attivazione:

1. Apri un file .js.
2. Assicurati che in basso a destra il linguaggio sia impostato su Strudel.
3. Esegui il comando Strudel: Open Panel per caricare l'interfaccia nel pannello laterale.
4. Importante: Clicca fisicamente sul pannello per attivare l'audio (sblocco sicurezza browser).

3. Configurazione Audio & OSC

Per far uscire l'audio dalla Focusrite e inviare i messaggi corretti:

• Hardware: Vai in Preferenze di Sistema > Suono > Uscita e seleziona Focusrite USB.
• Software: Poiché stai usando l'engine integrato (senza SuperCollider installato per ora), il routing OSC serve a Strudel per comunicare internamente tra l'editor e il pannello.

4. Test di Avvio (Run Semplice)

Crea un file test.js e incolla questo blocco. Seleziona tutto e premi Shift + Enter:

// Inizializza il bridge audio
await samples('https://raw.githubusercontent.com/tidalcycles/Dirt-Samples/master/');

setcps(1); // 120 BPM

// Test Sequenza
stack(
  s("bd*4").gain(0.8), // Cassa dritta
  s("hh*8").gain(0.6)  // Hi-hat
)

---

⚠️ Note per Mac non recenti

• Se senti scoppiettii (buffer underrun), chiudi il browser Chrome se lo hai aperto in contemporanea: l'estensione di VS Code consuma già risorse RAM/CPU.
• Se il comando Shift + Enter non risponde, controlla che il terminale con pnpm run dev sia ancora attivo e non sia andato in crash.