Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
C# audioaudio-unitavaloniacpp20cross-platformdawdigital-audio-workstationdspjucelinux-audiomcp-servermidimusicmusic-productionpiano-rollplugin-hostsequencersynthesizervstvst3
Quickstart: validating key-based texts and downloadable languages
Prerequisites: a Release build (scripts/build.sh), gh signed in, Python 3.
Use a throw-away data root: export NOTA_DATA_DIR=$(mktemp -d).
PR 1 — keys, no visible change (story 1, SC-001…003)
Baseline (pre-migration) commit: 7b58fe881bc6503e0ff7508dc1bd4c180dc909bd (origin/develop, 2026-11-04).
- Before migrating, capture reference screens in English and French with the headless shots
harness (
NOTA_UI_LANGUAGE=en/fr), every window of the nota-docs shot list. python3 scripts/loc-migrate.py --plan→ reviewkeymap.tsv; thenpython3 scripts/loc-migrate.py --apply.scripts/build.sh→ green; the localization block of the smoke test reports keys used = keys inen.json, 0 contexts, 0 text-keyed calls.python3 scripts/loc-migrate.py --verify <pre-migration commit>→ for every old call site,en[new key]equals the old English text andfr[new key]the old French value: 0 differences. Re-capture the screens and compare with step 1 as a spot check (SC-002).- Change one English value in
en.json, rebuild, run in French → same French text; smoke test green (SC-001). - Add
Loc.T("nope.missing")→ smoke test fails naming the key; add an unused key toen.json→ fails naming it.
PR 2 — nota-translations (story 2, SC-004)
gh workflow run publish.yml --repo nota-daw/nota-translations→reference/develop.jsonandindex.jsonappear on thepublishedbranch, committed by the bot.- Open a PR that breaks a placeholder in
languages/fr.json→check.ymlfails naming the key, in < 5 min; fix it → passes and reports French coverage. - Run
tools/validate.py --fixturesand the app smoke test's fixture parity check → same verdicts.
PR 3 — downloading (stories 3–5, SC-005…008)
Serve a test copy: python3 -m http.server -d <nota-translations checkout> and
export NOTA_LANGUAGES_URL=http://127.0.0.1:8000 (layout <base>/published/index.json,
<base>/<commit>/<path> reproduced by the smoke fixture builder).
- Clean data dir, open Preferences → Language: English + Français · 100% (available).
Pick it →
Downloading…→ restart note; restart → French (SC-005). - Stop the server, restart → French (SC-006); open the row →
More languages are available online. - Bump
versionand content offrin the copy, restart with the server up →Update available. - Corrupt the served file (checksum mismatch) →
Couldn't download…, installed copy kept. - Settings with
"Language": "fr", emptylanguages/, server up → starts in English, status barFrançais is ready+ Restart → French after restart (SC-007). Server down → English, row says it will download when online. - Load file… with
tests/Nota.SmokeTest/Fixtures/Languages/xx-broken.json→ restart → valid entries translated, broken ones English, problems listed. CheckForUpdatesoff → no request at start (watch the server log); Show available languages fetches on click.- Inspect the package (
.app/ installer / AppImage): onlyen.jsonembedded (SC-008). scripts/build.sh→ green, including the catalog smoke checks on the local fixture.