Tab Flow

pending

by Jay Bridge

Play, render and create interactive guitar tabs. Your tablature toolkit that supports popular formats like Guitar Pro (.gp3-.gpx) and writing your own in plain text (alphaTex).

★ 22 starsUpdated 1mo agoMPL-2.0Discovered via Obsidian Unofficial Plugins
View on GitHub

DOI CI GitHub release (latest by date) Ask DeepWiki

Tab Flow (Obsidian plugin)

Play and create your guitar tabs in Obsidian!

image image

Feature

  • Render and play guitar pro files (.gp, .gp3, .gp4, .gp5, .gpx).
    • Render tabs
    • PlayPause/Stop
    • cursor
    • Darkmode
    • auto-scroll
    • Control components (tracks control, save settings, Layout, Zoom, Speed, CountIn, Metronome)
  • Write scores in alphaTex (.atex or alphaTex codeblock in .md) and share it.
    • Highlight syntax (codemirror plugin)
    • gp export
    • pdf(wip)
    • png card
  • Built-in doc for you to learn and enjoy alphaTex.

Customed Play experience

visual-editor-playbar

Write Guitar Tabs like Markdown

.atex

image

alphaTex codeblock in .md

alphatex-copy-and-paste-writing

Share your riff (Beta)

image

Learn alphaTex in built-in interactive playground

image

Enter the document view by command or click the robbin icon guitar.

alphatex-and-doc

Install & Enable Play Font

1 install by bart42 (recommended, provide detailed version control & beta access)

  1. Install Brat plugin (if not yet)
  • search for BRAT
  • Install & enable BRAT
  1. Add Tab Flow plugin
  • Jump to Option
  • Add beta plugin
https://github.com/LIUBINfighter/Obsidian-Tab-Flow
  • Select version & Add plugin
  1. Download missing assets
  • Open Tab Flow settingTab
  • Downding missing asset files
  • Reload Tab Flow plugin or Obsidian app
image image image

download-assets

For Security reason, obsidian community plugin can't request from web automatically to prevent potential malicious attack, so it's neccesarry for you to do manually comfirm.

Tab Flow plugin uses a npm package @coderline/alphatab github repo, where the package content (font & sound font) comes from. We plan to provide other font resources when ready.

Currently Tab Flow plugin downloads assets fromm github release(frozen and immutable release/tag, 0.0.5 for now). If you do concern about the code, please refer to the latest tag & release.

2 download by github release & manual install

image

Release tab-flow.zip contains assets in right dictory position, so there is no need to download assets and reload again.

3 (Unable, currently in review queue) Obsidian Community Plugin Market

Click here or search Tab Flow and enable it.

RoadMap

  • 0.3.x (we are here!) maintain
  • 0.4.x (work in progress) Refactor player and editor (React and Zustand), introduce alphaTex 2.0 when ready.
  • 0.?.x Not sure yet.
  • 1.0.0 Train a vlm for alphaTex ocr and integrate it in tab-flow.

Contributing

Thanks for downloading this plugin and I appreciate it if you can help contribute!

If you have any feature requests / bugs to report, feel free to have an issue.

If you have done something brilliant, then go for a pull request. Before you push something, better to start a discussion or issue, so we can discuss it together.

Inspired by ...

AlphaTab.js

Bocchi the rock!

Girls' Band Cry

Disclaimer

Please make a backup for your gp files. Currently Tab flow will not rewrite back to your guitar pro files but some tabs rendered with bad results because of the different encoding methods for Chinese/Japanese/... characters (CJK) or some other encoding reasons.

This plugin can't automatically download font, soundfont and worker.mjs for you due to obsidian's policy about community plugins. However, we provide a bottom to complete the settings.

Copyright & Credit

Copyright (c) 2025 Jay Bridge and other contributors. All rights reserved.

Licensed under the MPL 2.0 License.

Alt

Special Thanks to

alphaTab logo

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.