Hacktoberfest 2026：維護者為十月標記出來的 issue，仍然開放、適合新手。 瀏覽 Hacktoberfest issue

Add Optional Settings below-tab lyric placement for tab-only and standard+tab layouts

未關閉
  • 哪裡不對？
#2,776 0 則留言 0 個 reaction 已指派 1 人 在 GitHub 檢視

維護者通常 1 天內回覆

@Danielku15 已經在處理了。

開始於 2026年7月10日。

評估

這個 Issue 還沒有評估資料。

描述

Discussed in https://github.com/CoderLine/alphaTab/discussions/2761

Originally posted by AvaTheArchitect July 3, 2026

Summary

This is a feature request for optional lyric placement in tab-focused layouts.

Currently, lyrics render above the tab staff. That may be expected current behavior, but in tab-only or standard+tab guitar layouts, lyrics can compete with bends, dive bombs, slides, vibrato, technique text, and other above-staff guitar effects.

The request is to add an option to render lyrics below the tab staff.

Problem

For guitar tracks, the area above the tab staff is often already occupied by guitar-specific notation:

  • full bends
  • dive bombs / whammy effects
  • slides
  • vibrato
  • technique text
  • phrase markings
  • other effect lanes

When lyrics are also placed above the tab staff, the renderer may need a large amount of vertical space to avoid collisions. Even with improved skyline/effect positioning, above-staff lyrics can still be a poor fit because the upper lane is already crowded by guitar notation.

This is especially visible in tab-only layouts or standard+tab layouts where lyrics would often be more readable below the tab staff.

Requested behavior

Add an option to place lyrics below the tab staff in tab-focused layouts.

Possible API shape:

tabLyricsPosition: "above" | "below" | "hide"
Expected behavior:
  • In tab-only layouts, allow lyrics below the tab staff.
  • In standard+tab layouts, allow lyrics below the tab staff rather than competing with above-staff guitar effect lanes.
  • Allocate appropriate below-staff spacing so lyrics do not overlap the next system.
  • Preserve current above-staff behavior as the default if preferred.
  • Optionally support hiding lyrics, matching the common notation-editor behavior.

Reference behavior

Guitar Pro provides a lyrics placement option under text/style settings with choices such as:

  • Above Staff
  • Below Staff
  • Hide

The attached Guitar Pro screenshots show this setting directly.

This makes tab-focused guitar layouts more readable when the upper staff area is occupied by bends, dive bombs, and other guitar effects.




Screenshot 2026-07-03 at 8 54 23 AM





Image 1 — Problem example
In the attached Guns N’ Roses example, the lead guitar track includes lyrics plus upper-staff guitar effects. Because the lyrics are above the tab staff, they compete with bends/divebombs/effects and require significant vertical headroom.




Screenshot 2026-07-03 at 12 15 02 PM





Image 2 — Expected visual direction / proof of concept
The attached Maestro screenshot shows a custom below-staff lyric overlay rendered under the tab staff. This is not being proposed as the exact implementation for alphaTab, but it demonstrates the layout goal:

  • lyrics sit below the tab staff
  • the upper effect lanes remain available for guitar techniques
  • the tab-focused layout becomes easier to read





Screenshot 2026-07-03 at 12 26 22 PM




Image 3 — Guitar Pro setting
Guitar Pro stylesheet setting showing Lyrics set to Below Staff.




Screenshot 2026-07-03 at 12 25 05 PM


Image 4 — Guitar Pro available options
Guitar Pro dropdown showing Above Staff, Below Staff, and Hide.




Screenshot 2026-07-03 at 12 25 17 PM


Image 5 — Guitar Pro available options (expanded menu drawer)

Guitar Pro dropdown showing Above Staff, Below Staff, and Hide.

主要語言
TypeScript
星號
1.9k
分支
297
平均合併
9 小時 41 分鐘
30 天內合併 PR
41

環境準備

這個專案沒有提供開發容器、Dockerfile 或貢獻指南，環境需要你自己搭建：先看它的 README，通用步驟見我們的新手貢獻指南。

從這裡開始

  1. 先讀完整個 Issue，再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫，在一個分支上完成修改。
  4. 送出 Pull Request，並在描述裡引用這個 Issue 編號。

CoderLine/alphaTab 的其他 Issue

查看 CoderLine/alphaTab 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。