Skip to content

docs: ScoreData vocal palettes #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jamiesun merged 1 commit into from
Aug 20, 2026
+30 −2
Merged

docs: ScoreData vocal palettes #18

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 11 additions & 2 deletions docs-site/src/profiles.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ workflow — see [Building a Sound Library](sound-library.md).
## Orchestration profiles

```yaml
# orchestration.yaml
# orchestration.yaml — minimal teaching example (two roles)
schema_version: 1
name: hybrid-cinematic
default_palette: ensemble
Expand All @@ -25,6 +25,14 @@ palettes:
profile: ../renderers/scoredata-symphonic.yaml
```

The ScoreData companion ships a fuller `hybrid-cinematic.yaml` with **11**
palettes: arrangement roles `default` / `solo` / `ensemble` / `electronic`,
plus thin vocal colours (`choir_male`, `choir_female`, `voice_solo`,
`choir_aahs`, `voice_oohs`, `choir_treble`, `voice_whisper`). Vocal palettes
are intentionally thin (only `choir` / `voice` / `choir_pad`); supporting
tracks stay on an arrangement role. See
[Building a Sound Library](sound-library.md#vocals-scoredata-vocal-palettes).

```bash
scorekit schema --orchestration
scorekit orchestration check orchestration.yaml
Expand All @@ -34,7 +42,8 @@ scorekit --json orchestration check orchestration.yaml
`orchestration check` loads every referenced leaf profile relative to the
orchestration file, resolves every leaf profile's `.sfz` paths, and fails
loudly — with no partial output — if a palette's leaf profile or any mapped
SFZ file is missing.
SFZ file is missing. A build takes **exactly one** `--orchestration` file;
layer multiple identities with per-track `palette:`, not multiple flags.

Each scene track carries a stable `id` and an optional `palette`
(`[a-z][a-z0-9_-]{0,63}`, same syntax as `id`). A track that omits `palette`
Expand Down
17 changes: 17 additions & 0 deletions docs-site/src/sound-library.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,23 @@ CC0-1.0 unless noted.
| Button Accordion HN | 2024-03-29 | |
| MuldjordKit (acoustic drums) | 2020-10-18 | CC-BY-4.0 |

### Vocals (ScoreData vocal palettes)

| Library | Version | License | Channel / notes |
|---|---|---|---|
| VPO Vocals (male/female/mixed) | 3.2 waves + 3.3 scripts | VPO mixed-open (no repackaging) | Local `scoredata-fix1` strips `delay_random`; male exposed via `scoredata-choir-male` palette |
| Legato Vocal Tutorial (Hadzi-Fia a) | 0.100 | CC0-1.0 | `github.com/sfzinstruments/legato_vocal_tutorial` — solo `a` vowel only |
| MuseScore GM vocal extract | 0.2.0 | MIT (from MuseScore General) | Deterministic extract of GM 52/53/54/91 → `libraries/musescore/gm-vocals/0.2.0` (Aahs/Oohs/Synth/Space + treble/whisper filters) |

Orchestration entrypoints (ScoreData companion):

| file | default | notes |
|---|---|---|
| `profiles/orchestrations/hybrid-cinematic.yaml` | `default` | **General cinematic entry** — 11 palettes: arrangement roles `default` / `solo` (chamber) / `ensemble` / `electronic`, plus thin vocals `choir_male` / `choir_female` / `voice_solo` / `choir_aahs` / `voice_oohs` / `choir_treble` / `voice_whisper`. One `--orchestration` per build. |
| `profiles/orchestrations/scoredata-vocals.yaml` | `mixed` | Vocals-only short names (`male`, `female`, `solo`, `aahs`, `oohs`, `treble`, `whisper`) over the **same** thin leaf profiles. |

Thin vocal palettes map only `choir` / `voice` / `choir_pad` — put supporting instruments on `default` (or another arrangement role). `treble` is a high-pass filter colour, not a children's choir; `whisper` is a soft filter, not breath phonation. World/ethnic sung vocals remain an honest coverage gap.

### Community one-offs

| Library | Version | License | Channel |
Expand Down
2 changes: 2 additions & 0 deletions docs/research/open-sample-libraries.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,8 @@ scorekit 当前构建脚本固定 sfizz 1.2.3。sfizz 官方 1.2.3 README 同时
- **sfizz 风险：中到高**。教程的价值恰恰在复杂 legato/CC/include；scorekit 当前 articulation 只选文件，不会主动发送这些控制状态。只能先取最简单的 polyphonic patch 做实验。
- **官方来源**：[项目说明](https://github.com/sfzinstruments/legato_vocal_tutorial) · [CC0 LICENSE](https://github.com/sfzinstruments/legato_vocal_tutorial/blob/main/LICENSE) · [v0.100 下载](https://github.com/sfzinstruments/legato_vocal_tutorial/releases/tag/v0.100)

**ScoreData 状态（2026-08-03）：** 已安装并认证。仅映射 polyphonic no-legato `a` 元音为 `scoredata-voice-solo` palette 的 `voice`。多元音第二套 choir/voice 色彩改由 MuseScore General GM 52/53/54/91 确定性提取（`musescore/gm-vocals`）提供；VPO male 经 `scoredata-fix1` 暴露为 `male` palette。不要把教程的 multi-vowel 模块当完整库（v0.100 未附带 o/u/e 样本）。

## 暂不纳入短名单

| 项目 | 分类 | 暂不采用的原因 | 官方证据 |
Expand Down
Loading