soundroo 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +3 -1
- package/README.md +11 -3
- package/THIRD_PARTY_NOTICES.md +1 -1
- package/assets/reverb/hall.wav +0 -0
- package/assets/samples/SOURCES.md +233 -333
- package/assets/samples/samples.json +51856 -363
- package/bin/soundroo.js +25 -3
- package/docs/composing.md +24 -7
- package/docs/headless.md +19 -6
- package/package.json +1 -1
- package/src/arrangement.js +2 -1
- package/src/audio/convolution.js +121 -0
- package/src/audio/library.js +194 -0
- package/src/audio/midi-import.js +174 -0
- package/src/audio/midi.js +27 -4
- package/src/audio/sampler.js +208 -52
- package/src/audio/synth.js +129 -6
- package/src/catalog.js +6 -6
- package/src/cloud/payload.js +2 -1
- package/src/headless.js +37 -9
- package/src/identity.js +14 -4
- package/src/project.js +20 -7
- package/src/render.js +121 -46
- package/src/samples-install.js +103 -0
- package/src/score.js +72 -15
- package/src/timeline.js +50 -0
- package/src/version.js +1 -1
- package/assets/samples/brass/39-1-1.wav +0 -0
- package/assets/samples/brass/41-1-1.wav +0 -0
- package/assets/samples/brass/45-1-1.wav +0 -0
- package/assets/samples/brass/46-1-1.wav +0 -0
- package/assets/samples/brass/50-1-1.wav +0 -0
- package/assets/samples/brass/53-1-1.wav +0 -0
- package/assets/samples/brass/57-1-1.wav +0 -0
- package/assets/samples/brass/60-1-1.wav +0 -0
- package/assets/samples/brass/63-1-1.wav +0 -0
- package/assets/samples/brass/67-1-1.wav +0 -0
- package/assets/samples/brass/70-1-1.wav +0 -0
- package/assets/samples/brass/74-1-1.wav +0 -0
- package/assets/samples/brass/77-1-1.wav +0 -0
- package/assets/samples/brass/81-1-1.wav +0 -0
- package/assets/samples/closed-hat/42-1-1.wav +0 -0
- package/assets/samples/closed-hat/42-1-2.wav +0 -0
- package/assets/samples/closed-hat/42-2-1.wav +0 -0
- package/assets/samples/closed-hat/42-2-2.wav +0 -0
- package/assets/samples/closed-hat/42-3-1.wav +0 -0
- package/assets/samples/closed-hat/42-3-2.wav +0 -0
- package/assets/samples/crash/49-1-1.wav +0 -0
- package/assets/samples/crash/49-2-1.wav +0 -0
- package/assets/samples/electric-bass/24-1-1.wav +0 -0
- package/assets/samples/electric-bass/24-2-1.wav +0 -0
- package/assets/samples/electric-bass/26-1-1.wav +0 -0
- package/assets/samples/electric-bass/26-2-1.wav +0 -0
- package/assets/samples/electric-bass/29-1-1.wav +0 -0
- package/assets/samples/electric-bass/29-2-1.wav +0 -0
- package/assets/samples/electric-bass/32-1-1.wav +0 -0
- package/assets/samples/electric-bass/32-2-1.wav +0 -0
- package/assets/samples/electric-bass/35-1-1.wav +0 -0
- package/assets/samples/electric-bass/35-2-1.wav +0 -0
- package/assets/samples/electric-bass/38-1-1.wav +0 -0
- package/assets/samples/electric-bass/38-2-1.wav +0 -0
- package/assets/samples/electric-bass/41-1-1.wav +0 -0
- package/assets/samples/electric-bass/41-2-1.wav +0 -0
- package/assets/samples/electric-bass/44-1-1.wav +0 -0
- package/assets/samples/electric-bass/44-2-1.wav +0 -0
- package/assets/samples/electric-bass/47-1-1.wav +0 -0
- package/assets/samples/electric-bass/47-2-1.wav +0 -0
- package/assets/samples/electric-bass/50-1-1.wav +0 -0
- package/assets/samples/electric-bass/50-2-1.wav +0 -0
- package/assets/samples/electric-bass/53-1-1.wav +0 -0
- package/assets/samples/electric-bass/53-2-1.wav +0 -0
- package/assets/samples/electric-bass/56-1-1.wav +0 -0
- package/assets/samples/electric-bass/56-2-1.wav +0 -0
- package/assets/samples/electric-bass/59-1-1.wav +0 -0
- package/assets/samples/electric-bass/59-2-1.wav +0 -0
- package/assets/samples/electric-bass/62-1-1.wav +0 -0
- package/assets/samples/electric-bass/62-2-1.wav +0 -0
- package/assets/samples/guitar-clean/40-1-1.wav +0 -0
- package/assets/samples/guitar-clean/41-1-1.wav +0 -0
- package/assets/samples/guitar-clean/45-1-1.wav +0 -0
- package/assets/samples/guitar-clean/48-1-1.wav +0 -0
- package/assets/samples/guitar-clean/50-1-1.wav +0 -0
- package/assets/samples/guitar-clean/52-1-1.wav +0 -0
- package/assets/samples/guitar-clean/55-1-1.wav +0 -0
- package/assets/samples/guitar-clean/59-1-1.wav +0 -0
- package/assets/samples/guitar-clean/61-1-1.wav +0 -0
- package/assets/samples/guitar-clean/64-1-1.wav +0 -0
- package/assets/samples/guitar-clean/67-1-1.wav +0 -0
- package/assets/samples/guitar-clean/71-1-1.wav +0 -0
- package/assets/samples/guitar-clean/72-1-1.wav +0 -0
- package/assets/samples/guitar-clean/74-1-1.wav +0 -0
- package/assets/samples/guitar-clean/77-1-1.wav +0 -0
- package/assets/samples/guitar-clean/80-1-1.wav +0 -0
- package/assets/samples/guitar-clean/82-1-1.wav +0 -0
- package/assets/samples/guitar-clean/85-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/40-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/41-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/45-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/48-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/50-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/52-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/55-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/59-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/61-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/64-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/67-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/71-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/72-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/74-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/77-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/80-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/82-1-1.wav +0 -0
- package/assets/samples/guitar-crunch/85-1-1.wav +0 -0
- package/assets/samples/open-hat/46-1-1.wav +0 -0
- package/assets/samples/open-hat/46-2-1.wav +0 -0
- package/assets/samples/piano/102-1-1.wav +0 -0
- package/assets/samples/piano/102-2-1.wav +0 -0
- package/assets/samples/piano/105-1-1.wav +0 -0
- package/assets/samples/piano/105-2-1.wav +0 -0
- package/assets/samples/piano/108-1-1.wav +0 -0
- package/assets/samples/piano/108-2-1.wav +0 -0
- package/assets/samples/piano/21-1-1.wav +0 -0
- package/assets/samples/piano/21-2-1.wav +0 -0
- package/assets/samples/piano/24-1-1.wav +0 -0
- package/assets/samples/piano/24-2-1.wav +0 -0
- package/assets/samples/piano/27-1-1.wav +0 -0
- package/assets/samples/piano/27-2-1.wav +0 -0
- package/assets/samples/piano/30-1-1.wav +0 -0
- package/assets/samples/piano/30-2-1.wav +0 -0
- package/assets/samples/piano/33-1-1.wav +0 -0
- package/assets/samples/piano/33-2-1.wav +0 -0
- package/assets/samples/piano/36-1-1.wav +0 -0
- package/assets/samples/piano/36-2-1.wav +0 -0
- package/assets/samples/piano/39-1-1.wav +0 -0
- package/assets/samples/piano/39-2-1.wav +0 -0
- package/assets/samples/piano/42-1-1.wav +0 -0
- package/assets/samples/piano/42-2-1.wav +0 -0
- package/assets/samples/piano/45-1-1.wav +0 -0
- package/assets/samples/piano/45-2-1.wav +0 -0
- package/assets/samples/piano/48-1-1.wav +0 -0
- package/assets/samples/piano/48-2-1.wav +0 -0
- package/assets/samples/piano/51-1-1.wav +0 -0
- package/assets/samples/piano/51-2-1.wav +0 -0
- package/assets/samples/piano/54-1-1.wav +0 -0
- package/assets/samples/piano/54-2-1.wav +0 -0
- package/assets/samples/piano/57-1-1.wav +0 -0
- package/assets/samples/piano/57-2-1.wav +0 -0
- package/assets/samples/piano/60-1-1.wav +0 -0
- package/assets/samples/piano/60-2-1.wav +0 -0
- package/assets/samples/piano/63-1-1.wav +0 -0
- package/assets/samples/piano/63-2-1.wav +0 -0
- package/assets/samples/piano/66-1-1.wav +0 -0
- package/assets/samples/piano/66-2-1.wav +0 -0
- package/assets/samples/piano/69-1-1.wav +0 -0
- package/assets/samples/piano/69-2-1.wav +0 -0
- package/assets/samples/piano/72-1-1.wav +0 -0
- package/assets/samples/piano/72-2-1.wav +0 -0
- package/assets/samples/piano/75-1-1.wav +0 -0
- package/assets/samples/piano/75-2-1.wav +0 -0
- package/assets/samples/piano/78-1-1.wav +0 -0
- package/assets/samples/piano/78-2-1.wav +0 -0
- package/assets/samples/piano/81-1-1.wav +0 -0
- package/assets/samples/piano/81-2-1.wav +0 -0
- package/assets/samples/piano/84-1-1.wav +0 -0
- package/assets/samples/piano/84-2-1.wav +0 -0
- package/assets/samples/piano/87-1-1.wav +0 -0
- package/assets/samples/piano/87-2-1.wav +0 -0
- package/assets/samples/piano/90-1-1.wav +0 -0
- package/assets/samples/piano/90-2-1.wav +0 -0
- package/assets/samples/piano/93-1-1.wav +0 -0
- package/assets/samples/piano/93-2-1.wav +0 -0
- package/assets/samples/piano/96-1-1.wav +0 -0
- package/assets/samples/piano/96-2-1.wav +0 -0
- package/assets/samples/piano/99-1-1.wav +0 -0
- package/assets/samples/piano/99-2-1.wav +0 -0
- package/assets/samples/ride/51-1-1.wav +0 -0
- package/assets/samples/ride/51-2-1.wav +0 -0
- package/assets/samples/rock-kick/36-1-1.wav +0 -0
- package/assets/samples/rock-kick/36-1-2.wav +0 -0
- package/assets/samples/rock-kick/36-2-1.wav +0 -0
- package/assets/samples/rock-kick/36-2-2.wav +0 -0
- package/assets/samples/rock-kick/36-3-1.wav +0 -0
- package/assets/samples/rock-kick/36-3-2.wav +0 -0
- package/assets/samples/rock-kick/36-4-1.wav +0 -0
- package/assets/samples/rock-kick/36-4-2.wav +0 -0
- package/assets/samples/rock-snare/38-1-1.wav +0 -0
- package/assets/samples/rock-snare/38-1-2.wav +0 -0
- package/assets/samples/rock-snare/38-2-1.wav +0 -0
- package/assets/samples/rock-snare/38-2-2.wav +0 -0
- package/assets/samples/rock-snare/38-3-1.wav +0 -0
- package/assets/samples/rock-snare/38-3-2.wav +0 -0
- package/assets/samples/rock-snare/38-4-1.wav +0 -0
- package/assets/samples/rock-snare/38-4-2.wav +0 -0
- package/assets/samples/strings/36-1-1.wav +0 -0
- package/assets/samples/strings/40-1-1.wav +0 -0
- package/assets/samples/strings/43-1-1.wav +0 -0
- package/assets/samples/strings/47-1-1.wav +0 -0
- package/assets/samples/strings/50-1-1.wav +0 -0
- package/assets/samples/strings/53-1-1.wav +0 -0
- package/assets/samples/strings/55-1-1.wav +0 -0
- package/assets/samples/strings/59-1-1.wav +0 -0
- package/assets/samples/strings/62-1-1.wav +0 -0
- package/assets/samples/strings/65-1-1.wav +0 -0
- package/assets/samples/strings/69-1-1.wav +0 -0
- package/assets/samples/strings/72-1-1.wav +0 -0
- package/assets/samples/strings/76-1-1.wav +0 -0
- package/assets/samples/strings/79-1-1.wav +0 -0
- package/assets/samples/strings/83-1-1.wav +0 -0
- package/assets/samples/strings/86-1-1.wav +0 -0
- package/assets/samples/tom/41-1-1.wav +0 -0
- package/assets/samples/tom/41-2-1.wav +0 -0
- package/assets/samples/tom/45-1-1.wav +0 -0
- package/assets/samples/tom/45-2-1.wav +0 -0
- package/assets/samples/tom/48-1-1.wav +0 -0
- package/assets/samples/tom/48-2-1.wav +0 -0
- package/assets/samples/tom/50-1-1.wav +0 -0
- package/assets/samples/tom/50-2-1.wav +0 -0
package/AGENTS.md
CHANGED
|
@@ -43,7 +43,7 @@ Read the person's words and decide the normal things yourself: style, tempo, ins
|
|
|
43
43
|
|
|
44
44
|
Never overwrite or delete an existing library. The built-in example collection (Turn It Up) is a demonstration, not the person's music.
|
|
45
45
|
|
|
46
|
-
3. **Write the score.** Use version 2 scores with compact `steps` and `line` patterns placed with `clips`, or write a small script in the library that builds the score with the helpers in `src/compose.js`. Plan the sections and where the energy goes before writing notes. Keep the score and any script in the library so the music stays editable.
|
|
46
|
+
3. **Write the score.** Use version 2 scores with compact `steps` and `line` patterns placed with `clips`, or write a small script in the library that builds the score with the helpers in `src/compose.js`. Plan the sections and where the energy goes before writing notes. Keep the score and any script in the library so the music stays editable. For piano music and anything that should breathe, use a version 3 score: pedal each harmony with `pedal` spans and shape the time with `tempo` changes (a ritardando into the ending). Shape dynamics note by note with velocity; the piano's sixteen recorded layers make soft notes sound soft, not just quiet. If you'd rather write MIDI with a script, `node bin/soundroo.js import-midi <file.mid> --add --library library/<name>` turns it into a score.
|
|
47
47
|
|
|
48
48
|
4. **Check and add it.**
|
|
49
49
|
|
|
@@ -60,6 +60,8 @@ Read the person's words and decide the normal things yourself: style, tempo, ins
|
|
|
60
60
|
node bin/soundroo.js render --all --library library/<name> --json
|
|
61
61
|
```
|
|
62
62
|
|
|
63
|
+
The first render with recorded instruments downloads their recordings once (up to about 4 GB, a few minutes; the piano alone is 2 GB). Give that command a long timeout or run `node bin/soundroo.js samples --all` in the background first. If a download is interrupted, running the command again continues it.
|
|
64
|
+
|
|
63
65
|
Read the report. Fix every warning. Act on the `suggestions` too (drums that come in late, four bars that repeat unchanged for too long, sections that all sound the same, a long silent ending) unless the person asked for exactly that. Every render is mastered to the same loudness, so don't raise the master volume to make it louder. These checks find technical and arrangement problems; they can't tell you whether it sounds good. You can't hear the music, so don't claim it sounds great.
|
|
64
66
|
|
|
65
67
|
6. **Open the player.** Start the studio in a session that keeps running, and don't stop it while the person listens:
|
package/README.md
CHANGED
|
@@ -57,8 +57,15 @@ note, then mixes and masters the parts into a stereo track.
|
|
|
57
57
|
|
|
58
58
|
The engine has 32 instrument types. Grand piano, string and brass sections,
|
|
59
59
|
clean and overdriven electric guitars, electric bass and an acoustic drum kit
|
|
60
|
-
play recordings of real instruments
|
|
61
|
-
|
|
60
|
+
play full recordings of real instruments in stereo: the piano has sixteen
|
|
61
|
+
loudness layers per note, its natural decay and its damper and pedal sounds,
|
|
62
|
+
and the drums, bass and guitars switch between several recorded takes (all
|
|
63
|
+
public domain; see [assets/samples/SOURCES.md](assets/samples/SOURCES.md)).
|
|
64
|
+
The recordings are about 4 GB. Soundroo downloads the ones a track needs the
|
|
65
|
+
first time it plays it, once, from this repository's releases
|
|
66
|
+
(`node bin/soundroo.js samples --all` gets them all ahead of time). Scores can
|
|
67
|
+
use the sustain pedal and tempo changes, and `node bin/soundroo.js import-midi`
|
|
68
|
+
turns any MIDI file into a score. Electric piano, organ,
|
|
62
69
|
analog and FM synthesizers, pads, synth basses, bells, marimba, a drum machine
|
|
63
70
|
and 8-bit chip sounds for video game music are synthesized. Short spoken phrases can become rhythmic chops, tape and grain
|
|
64
71
|
textures or a vocoder robot voice. The words come from
|
|
@@ -71,7 +78,8 @@ music is good. Because the track is a score, the agent can change one part and
|
|
|
71
78
|
keep the others. "Keep the melody, make the drums softer" works.
|
|
72
79
|
|
|
73
80
|
None of this needs an account, an API key, music software or a graphics card,
|
|
74
|
-
and none of it leaves your computer.
|
|
81
|
+
and none of it leaves your computer. Apart from that one download of the
|
|
82
|
+
recordings, it works offline. Your AI agent is a separate service with
|
|
75
83
|
its own terms and prices.
|
|
76
84
|
|
|
77
85
|
## The music player
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
@@ -4,6 +4,6 @@ The synthesis foundation in `src/audio/` includes code from [Explainroo](https:/
|
|
|
4
4
|
|
|
5
5
|
Optional speech synthesis uses [Kokoro](https://huggingface.co/hexgrad/Kokoro-82M) and [kokoro-js](https://github.com/hexgrad/kokoro). Kokoro's model and kokoro-js use Apache License 2.0. The runtime uses [Transformers.js](https://github.com/huggingface/transformers.js) under Apache License 2.0 and ONNX Runtime under MIT. Speech model and runtime files keep their upstream licenses.
|
|
6
6
|
|
|
7
|
-
The recorded instruments in `assets/samples
|
|
7
|
+
The recorded instruments (sample packs listed in `assets/samples/samples.json` and downloaded from this repository's `samples-2026-11` release) come from public-domain and CC0 sample libraries: Salamander Grand Piano V3 by Alexander Holm (public domain since 2022), Big Rusty Drums and Fashionbass by Karoryfer Lecolds (CC0 1.0), FreePats Electric Guitar FSBS by the FreePats project (CC0 1.0), and VSCO 2 Community Edition by Versilian Studios and Ivy Audio (CC0 1.0). [assets/samples/SOURCES.md](assets/samples/SOURCES.md) lists every source file and how it was processed. No attribution is required, but it is gladly given. The concert hall reverb's impulse response (`assets/reverb/hall.wav`) is generated by `scripts/reverb/hall.py` and has no outside source.
|
|
8
8
|
|
|
9
9
|
Soundroo contains no Apple Music, GarageBand or Ableton artwork, fonts, logos or application code. Those applications informed interaction and layout choices only.
|
|
Binary file
|