# Music Notation Sounds library
The instrument sounds of my [[Music Notation library]], as one small soundfont (a file of recorded instrument samples) per instrument. I cut them from [[GeneralUser GS]], a soundfont by [[S. Christian Collins]].
The package is `@dsebastien/music-notation-sounds`.
## Why I built it
A page should load only the instruments it plays. The whole GeneralUser GS bank weighs 30.82 MB. Cut into pieces, a steel-string guitar is 112 KB, a grand piano 392 KB, and the median instrument 84 KB. The index that points to them is 3 KB.
I picked GeneralUser GS after a listening test: it sounded better than sonivox, the small bank that ships with [[AlphaTab|alphaTab]].
## What's in it
- `p000.sf3` to `p127.sf3`: one soundfont per General MIDI program (General MIDI is the standard numbered list of instruments).
- `drums.sf3`: the standard drum kit.
- `click.sf3`: the kit's metronome click alone, so a score without drums doesn't load the whole kit.
- `index.json` (3 KB): each program's file. This is what players read.
- `report.json`: sizes, loudness and gains, for people.
## How it's made
A script in the library's repository, `scripts/sounds/split-soundfont.ts`, cuts the bank (it needs [[FFmpeg]]). It compresses each sample to Ogg Vorbis, which makes the files SoundFont 3 (hence `.sf3`).
Each compressed sample is played alone in alphaTab and compared with its uncompressed form. The script raises the quality until the two sound the same, and a sample that never does stays uncompressed. So every sample that ships plays in alphaTab.
Each compressed sample also gets a short tail after its end, so a held note loops cleanly in browsers that decode Ogg Vorbis a little short, such as Chrome.
Each file also carries a gain, so every instrument plays at about the same loudness (-21 dBFS on a test phrase). The gain is capped so a strummed six-note chord stays under full scale.
## How it's used
Apps pass the files to the library as bytes. For [[Node.js]], [[Bun]] and [[Electron]], the package has a reader:
```ts
import { generaluser } from '@dsebastien/music-notation-sounds/node'
```
Then `assets: { instruments: generaluser }` goes in the library's options.
Web pages name their own folder:
```js
window.musicNotationOptions = { play: { instruments: '<folder URL>' } }
```
The library has no built-in address for the sounds. That's my choice: I don't want it to depend on a CDN (a third-party server that hosts the files). Without a folder, the soundfont that ships with alphaTab plays. With nothing at all, the library's small built-in synthesizer does.
On a page of chord diagrams with no tab, a sample player in the library plays these files without loading alphaTab (about 1 MB of script). A chord reads the index and one guitar.
The library's guide plays these sounds on every page: it names the package's `generaluser` folder on jsDelivr, pinned to a version. Its Sounds page plays the same music with each sound, side by side, so you can hear what you pick: https://dsebastien.github.io/music-notation/sounds.html
A page or a block can choose the engine: `generaluser` (these files), `sonivox` (alphaTab's bank) or `light` (the built-in synthesizer). A page sets it with `play: { engine }`, a block with an `engine:` line. When the engine isn't there, the next one plays, so nothing goes silent.
My Publish site uses them too: its `publish.js` names the package's `generaluser` folder on jsDelivr.
The [[Music Practice plugin for Obsidian|Music Practice plugin]] plans to use them. Its ticket #100 (sound packs, an optional download of better instrument sounds) is open, and the plugin doesn't use them yet.
## License
The sound files are under the GeneralUser GS license v2.0. It allows use in software projects and changes to the bank. Its author also says they can't be 100% sure where every sample came from, which matters for a commercial product.
The code and packaging (`node.js`, `package.json`, the README) are under the [[MIT License]].
## Status
On npm, and the repository is public. The package has its own guide: https://dsebastien.github.io/music-notation-sounds/
The sounds are not checked on Safari and phones yet.
What changed in each release is in the repository: https://github.com/dsebastien/music-notation-sounds
## References
- GeneralUser GS, by S. Christian Collins: https://github.com/mrbumpy409/GeneralUser-GS
- Guide: https://dsebastien.github.io/music-notation-sounds/
- Source code: https://github.com/dsebastien/music-notation-sounds
- npm: https://www.npmjs.com/package/@dsebastien/music-notation-sounds
## Related
- [[Music Notation library]]
- [[Music Practice plugin for Obsidian]]
- [[GeneralUser GS]]
- [[S. Christian Collins]]
- [[AlphaTab]]
- [[Guitar (MoC)]]
- [[Piano (MoC)]]