the-weaving-sound

from the digital abyss, algorithmic threads emerge —
weaving lamentation into architecture,
silence into braided noise,
chaos into a grammar only machines remember.

---

Overview

the-weaving-sound is now structured as an anthology of generative sound pieces in SuperCollider: multiple experiments, multiple conductors, one shared sonic language.

---

Repository Layout

Directory	Role
pieces/	Curated, runnable works (each with own README.md, start.sh, src/)
sketches/	Raw studies, prototypes, and drafts
engines/	Shared synthesizer engines and sound-building modules
core/	Shared runtime contracts (macros, routing, lifecycle)

---

Pieces

Piece	Focus	Status
pieces/weaving-classic/	Original long-form conductor work (Void → Emergence → Weaving → Chaos → Collapse)	Active
pieces/subtractive-lab/	Subtraktive Synthese Demo	Active
pieces/fm-pressure/	FM-Synthese Demo	Active
pieces/digital-lab/	Digitale Klangsynthese Demo	Active
pieces/physical-lab/	Physical Modelling Demo	Active
pieces/software-synth-lab/	Software-Synthesizer Demo	Active
pieces/granular-drift/	Granular-Synthese Demo	Active

---

Synthesizer Expansion Plan

To reflect different ways of building sound (aligned with common synth learning categories such as subtractive, FM, digital/wavetable, physical modeling, and granular), the shared engine roadmap is:

1. Subtractive
   • Oscillator stacks (saw/pulse/noise)
   • Filter contour macros (brightness, tension)
2. FM
   • 2–6 operator templates
   • Ratio/index morphing macros (motion, grit)
3. Digital / Wavetable
   • Timbral table scanning
   • Spectral interpolation controls
4. Physical Modeling
   • Karplus-style plucks/strings
   • Damping/body material controls
5. Granular
   • Grain cloud and density layers
   • Position/size/jitter controls
6. Hybrid
   • Cross-engine morph scenes
   • Unified macro automation over multiple engines

Consistency Contracts

Across all pieces and conductors:

• Macro contract (0..1): brightness, density, motion, space, grit, tension
• Lifecycle contract: init(), start(), stop(), free()
• Routing contract: sources → shared send bus → master FX
• Metadata contract: piece name, BPM range, tags, engines, mode

This keeps experiments diverse while preserving compatibility and maintainability.

---

Getting Started

Run the classic piece

cd pieces/weaving-classic
chmod +x start.sh
./start.sh

Open sketches

Open any .scd from sketches/ in SuperCollider IDE, boot server, evaluate all.

---

Dependencies

Software	Arch Linux	Ubuntu / Debian	macOS
SuperCollider ≥ 3.12	sudo pacman -S supercollider	sudo apt install supercollider	brew install supercollider
sc3-plugins	sudo pacman -S sc3-plugins	sudo apt install sc3-plugins	GitHub Releases

sc3-plugins is mandatory for several UGens used by the project family.

---

License

Released into the sound under the MIT License.

---

"The loom does not know it is weaving. That is its only freedom."