Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Respect systems layout of MusicXML

Open
  • Is something wrong?
#2,909 0 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@Danielku15 is already working on this.

Since Oct 5, 2026.

Assessment

This issue has not been assessed yet.

Description

Most MusicXML files carry a lot of layout information which is neglected by alphaTab. As we have partial support for line breaks, this can lead to strange music sheet display.

To mitigate this problem alphaTab should try to infer the systems layout from given information like page sizes and measure widths and combine it correctly with system breaks to achieve the same layout when the music sheet is rendered with the Parchment layout.

Change on Page layout?

At the same time the Page layout should likely not respect the manual page breaks. I would consider the Page layout rather as a automatic Layout similar to the "Screen - Vertical" of Guitar Pro where all aspects are selected automatically by alphaTab. Parchment is the more explicit layout where we respect systems layouts, page breaks etc.

Reading and re-exposing the page layout information from input files is the next evolution.

Dominant language
TypeScript
Stars
1.9k
Forks
297
Avg merge
9h 41m
Merged PRs (30d)
41

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from CoderLine/alphaTab

All issues in CoderLine/alphaTab

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.