Audio to Band Score

An agent skill for turning a mixed song recording into a playable five-piece school band arrangement.

It combines time-aligned source separation, musical analysis, practical arranging, notation checks, and MuseScore export to deliver rehearsal-ready MIDI, PDF, and editable MSCZ files.

[!NOTE] This is an agent skill, not a standalone desktop application. It is designed to guide an agent through the full arrangement workflow while keeping musical decisions, evidence, and limitations explicit.

本项目认可并支持 LINUX DO 社区。

Version updates

Functional releases are recorded here with their version and date. Documentation-only changes do not create a new entry.

v0.2.0 — 2026-09-13

This functional update adds:

• A compact score-event model and deterministic MusicXML compiler for dead notes, mixed muted/open-string events, tuplets, grace notes, ties, and TAB output.
• Global single-note fingering and position planning for lead guitar and bass, bounded playability repair attempts, benchmarks, and hash-bound reports.
• Independent rhythm and note-level fidelity evidence audits, including reference-score and reviewed-mix/stems workflows.
• Stronger formal export gates for source/report binding, native dead-note playback, rhythm/fidelity checks, and explicit review-draft status.
• Expanded arranging and notation guidance, updated score templates, and regression coverage for the new workflow.

Score previews

These excerpts show representative bars from four generated five-piece arrangements. Each image is a lightweight PNG so it renders directly in GitHub's README view.

Beyond — 海阔天空

雑踏、僕らの街 — GBC

Alia — 声

Mygo — 春日影

Introduction video

▶ Watch the project introduction on Bilibili

Contents

• Version updates
• Score previews
• Introduction video
• What it does
• Default instrumentation
• Workflow
• Quick start
• Outputs
• Repository layout
• Quality model and limitations
• Testing
• Contributing
• Credits
• License

What it does

Audio to Band Score is built for users who have a finished song recording but need a practical band chart rather than raw stems or an unedited MIDI transcription.

Core capabilities

• Separates a mixed recording into time-aligned analysis stems with Demucs.
• Compares four-source and six-source separation results when the higher-quality profile is used.
• Identifies song sections, tempo candidates, time signatures, harmony, bass movement, riffs, fills, and musical entry points.
• Reassigns parts between two guitars, bass, keyboard, and drums with playability in mind.
• Supports beginner, school-amateur intermediate, and advanced difficulty targets.
• Produces a structured, editable MuseScore score instead of treating raw recognition output as a finished chart.
• Audits score structure, TAB string/fret relationships, export safety, and file consistency.
• Uses local and free tools by default; audio is not uploaded to a paid external API by this workflow.

Default instrumentation

The default arrangement is a five-instrument accompaniment for a singer: