Turn a score into music your hands can play

import { createScore, parsePitch, q, arrange, concertUkulele } from "scorify"; // A C major chord held for one 4/4 bar, as sounding pitches in exact quarter-note time.const notes = ["G4", "C4", "E4", "C5"].map((pitch, i) => ({  id: `c-${i}`, pitch: parsePitch(pitch), onset: q(0), duration: q(4),  partId: "uke", voiceId: "chords", role: "harmony",}));const score = createScore(notes, { tempoMap: [{ at: q(0), quarterBpm: 80 }] }); const result = arrange(score, {  instrument: concertUkulele(),   // G4 C4 E4 A4, high G  mode: "exact",                  // keep every pitch, onset and hold  player: { level: "beginner", overrides: { rightHand: "strum" } }, // one strum}); if (result.status === "success") {  console.log(result.annotations[0].shape);       // "0-0-0-3"  console.log(result.annotations[0].assignments); // string, fret and finger per note} else {  console.log(result.status, result.diagnostics);}

import { arrange, classicalGuitar } from "scorify"; const result = arrange(score, {  instrument: classicalGuitar({ capoFret: 2 }), // sounding pitch stays, frets move  mode: "adaptive",  transform: { interval: "2M", tempoScale: 0.75 },  player: { level: "amateur", overrides: { allowBarre: false } },  adaptation: {    preserveMelody: true,           // melody notes are never dropped    allowOctaveShift: true,         // revoice notes by an octave    allowAccompanimentOmission: true, // may drop notes marked bass/harmony  },}); if (result.status === "success") {  for (const edit of result.edits) console.log(edit.kind, edit.reason, edit.permission);  console.log(result.optimality); // "proven-in-model" or "best-found"}

import { createWorkerClient } from "scorify/worker";import { concertUkulele } from "scorify"; // Serve worker-entry.mjs from your own origin, next to its chunks.const worker = new Worker(new URL("./scorify/worker-entry.mjs", import.meta.url), { type: "module" });const client = createWorkerClient(worker); const result = await client.arrange(score, {  instrument: concertUkulele(), mode: "exact", player: { level: "pro" },}, (progress) => console.log(progress)); // A newer client.arrange() cancels this one; its stale reply is ignored.// Options must be serializable: call client.cancel() rather than passing an AbortSignal.client.dispose();worker.terminate();

import { createPerformance, createAudioPlayer, renderPerformance, encodeWav } from "scorify/audio"; // Use a successful result and the instrument that produced it.const performed = createPerformance(result, instrument, {  seed: "take-1",                                  // repeatable excitation and timing  humanize: 0.4,  strum: { direction: "down", spreadSeconds: 0.03 }, // false to pick});if (performed.status !== "success") throw new Error(performed.diagnostics.join("; ")); const context = new AudioContext();const player = await createAudioPlayer(context);playButton.onclick = async () => {           // start audio from a user gesture  const playback = await player.play(performed.performance);  console.log(await playback.finished);}; // Or render offline: the same samples as the worklet.const wav = encodeWav(renderPerformance(performed.performance));

// Show the solver's strings and frets in a defuss-shadcn Fretboard tab (4/4).const beats = (t) => t[0] / t[1]; // q(n, d) is [n, d] quarter notesconst items = result.annotations.flatMap((a) => {  const struck = a.assignments.filter((p) => p.noteIds.some((id) => a.attackIds.includes(id)));  if (!struck.length) return [];  const at = beats(a.at);  return [{ measure: Math.floor(at / 4) + 1, beat: (at % 4) + 1,    notes: struck.map((p) => ({ string: p.stringNumber, fret: p.relativeFret })) }];}); document.querySelector("#tab").api.setState("default", { data: {  version: 1, tuning: ["G", "C", "E", "A"],  scores: [{ id: "uke", tracks: [{ id: "tab", kind: "tab", items }] }],} });

# the skill's command line, from a checkout of the repositoryscore=skills/score-import/scripts/score.py # read a page: score links and inline notationpython3 $score visit "https://example.org/scores/greensleeves"python3 $score download "…/greensleeves.mid" --from "https://example.org/scores/greensleeves"python3 $score convert greensleeves.mid --pickup 1/2python3 $score check greensleeves.scorify.json

# in Claude Code: add the marketplace and install the skill/plugin install score-import --marketplace kyr0/scorify # once, for web pages: the browser it drivesbunx cloakbrowser install # then ask for a score, or call the skill/score-import:score-import Find a lead sheet of "Scarborough Fair" with melody, lyrics and chords and convert it to a scorify score

# in Codex: install the skill into ~/.codex/skills/score-import$skill-installer install https://github.com/kyr0/scorify/tree/main/skills/score-import # once, for web pages: the browser it drivesbunx cloakbrowser install # then ask for a score, or call the skill$score-import Find a lead sheet of "Scarborough Fair" with melody, lyrics and chords and convert it to a scorify score

# any agent that reads ~/.agents/skills, or one project's .claude/skillsgit clone --depth 1 --filter=blob:none --sparse https://github.com/kyr0/scorify.git ~/.scorifygit -C ~/.scorify sparse-checkout set skills/score-importmkdir -p ~/.agents/skills && ln -s ~/.scorify/skills/score-import ~/.agents/skills/score-import # once, for web pages: the browser it drivesbunx cloakbrowser install # later: updategit -C ~/.scorify pull