NAME

scripts\audio-products.cmd — preview-.mp3 maken bij een bibliotheek-bron

SYNOPSIS

scripts\audio-products.cmd [pad] [--force] [--dry-run]

DESCRIPTION

Maakt naast een bibliotheek-bron een afspeelbaar mp3-bestand zodat koorleden op de site op Beluisteren kunnen klikken. Per brontype een eigen sibling:

BronAudio-product
{stam}.mvsa{stam}.mvsa.mp3
{stam}.mscz (basispartituur){stam}.mscz.mp3
{stam}.vsa{stam}.vsa.mp3

Het script schrijft een herkomststempel in het mp3-bestand (zelfde velden als bij PDF/MXL: hash van de bron, wanneer gemaakt). Zo ziet check later of de bron is gewijzigd terwijl het mp3 nog oud is.

Zoekt onder het opgegeven pad (of, zonder pad, onder content-source\catalogus). Overgeslagen: input\, mappen met artefacten_handmatig: true, import-siblings *.mscz.mvsa, en .print.mscz.

Onder de motorkap: tooling-CLI vsa audio (MuseScore 4). Bij .vsa syllabificeert het script eerst in een tijdelijk bestand (zelfde als vsa-products voor Coria), zodat Beluisteren dezelfde lettergreep-noten heeft als Oefenen; de canonieke .vsa blijft ongewijzigd. CI genereert geen audio; jij wel lokaal, daarna committen.

Belangrijk: elke catalogus-.mvsa / basis-.mscz / .vsa (buiten handmatige mappen) hoort een passende .mp3 te hebben — dezelfde scope als de Coria-.mxl. Ontbreekt of veroudert die, dan faalt check --strict / CI. Maak ze lokaal met dit script (of all-products ); CI genereert geen MuseScore-audio.

OPTIONS

OptieBetekenis
--forceBestaande mp3’s overschrijven
--dry-runAlleen tonen wat er zou gebeuren

EXAMPLES

scripts\audio-products.cmd content-source\catalogus\alleluia\9a-toon-1\groningen
scripts\audio-products.cmd content-source\catalogus\tropaar\maandag-toon-4\hemelum --force

WHEN

Als je Beluisteren wilt tonen op een bladermap, of als check --strict meldt dat een bestaand .mp3 verouderd is.

SEE ALSO