{"id":29537874,"url":"https://github.com/liubinfighter/obsidian-tab-flow","last_synced_at":"2026-04-24T21:32:42.842Z","repository":{"id":296988551,"uuid":"993982366","full_name":"LIUBINfighter/Obsidian-Tab-Flow","owner":"LIUBINfighter","description":"Play and Create guitar tabs using AlphaTab. Modern music font and sound! (Support .alphatab, .gp, .gp3, .gp4, .gp5, .gpx)","archived":false,"fork":false,"pushed_at":"2025-07-06T07:30:57.000Z","size":4656,"stargazers_count":5,"open_issues_count":11,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-06T08:33:07.961Z","etag":null,"topics":["alphatab","guitar","midi","obsidian"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LIUBINfighter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T23:47:24.000Z","updated_at":"2025-07-06T07:15:37.000Z","dependencies_parsed_at":"2025-07-06T08:33:19.133Z","dependency_job_id":"ae242a30-445d-4b83-8efd-8300a6f6f998","html_url":"https://github.com/LIUBINfighter/Obsidian-Tab-Flow","commit_stats":null,"previous_names":["liubinfighter/obsidian-alphatab","liubinfighter/interactive-tabs","liubinfighter/obsidian-tab-flow"],"tags_count":10,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","purl":"pkg:github/LIUBINfighter/Obsidian-Tab-Flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIUBINfighter%2FObsidian-Tab-Flow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIUBINfighter%2FObsidian-Tab-Flow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIUBINfighter%2FObsidian-Tab-Flow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIUBINfighter%2FObsidian-Tab-Flow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LIUBINfighter","download_url":"https://codeload.github.com/LIUBINfighter/Obsidian-Tab-Flow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIUBINfighter%2FObsidian-Tab-Flow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265563717,"owners_count":23788746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alphatab","guitar","midi","obsidian"],"created_at":"2025-07-17T04:02:42.741Z","updated_at":"2026-02-24T19:02:26.116Z","avatar_url":"https://github.com/LIUBINfighter.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![DOI](https://zenodo.org/badge/993982366.svg)](https://doi.org/10.5281/zenodo.18446852)\n[![CI](https://github.com/LIUBINfighter/Obsidian-Tab-Flow/actions/workflows/ci.yml/badge.svg)](https://github.com/LIUBINfighter/Obsidian-Tab-Flow/actions/workflows/ci.yml)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/LIUBINfighter/Obsidian-Tab-Flow)](https://github.com/LIUBINfighter/Obsidian-Tab-Flow/releases/latest)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/LIUBINfighter/obsidian-tab-flow)\n\n\n# Tab Flow (Obsidian plugin)\n\nPlay and create your guitar tabs in Obsidian!\n\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/7334f1e9-cdc4-404e-81a7-89683ebfab7f\" /\u003e\n\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/3cfde6e3-e775-4507-9a13-ef4be31b0941\" /\u003e\n\n\u003c!-- \u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/c0ce49f5-ef6a-4e4d-a3aa-20b38a4be788\" /\u003e --\u003e\n\n\n## Feature\n\n- Render and play guitar pro files (.gp, .gp3, .gp4, .gp5, .gpx).\n  - Render tabs\n  - PlayPause/Stop\n  - cursor\n  - Darkmode\n  - auto-scroll\n  - Control components (tracks control, save settings, Layout, Zoom, Speed, CountIn, Metronome)\n- Write scores in `alphaTex` (.atex or `alphaTex` codeblock in .md) and share it.\n  - Highlight syntax (codemirror plugin)\n  - gp export\n  - pdf(wip)\n  - png card\n- Built-in doc for you to learn and enjoy alphaTex.\n\n### Customed Play experience\n\n\n![visual-editor-playbar](https://github.com/user-attachments/assets/4fce8ba1-31fa-4ca5-ab78-d721374ce975)\n\n\n### Write Guitar Tabs like Markdown\n\n`.atex`\n\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e3a86a1a-3a85-469f-aa07-bda97faaf891\" /\u003e\n\n`alphaTex` codeblock in `.md`\n\n![alphatex-copy-and-paste-writing](https://github.com/user-attachments/assets/ef402b18-9c3f-4e10-8772-a3fd8e50c507)\n\n\u003c!--![alphatex-copy-and-paste-writing-multiview](https://github.com/user-attachments/assets/30d1e922-d4d2-4edd-a68a-8b2f3bada705)--\u003e\n\n\n### Share your riff (Beta)\n\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/2f784059-4fef-4345-a6e4-d543ea7b2169\" /\u003e\n\n\n### Learn alphaTex in built-in interactive playground\n\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/df7ba557-2c15-4db8-bfdf-d011e5362a16\" /\u003e\n\nEnter the document view by command or click the robbin icon `guitar`.\n\n![alphatex-and-doc](https://github.com/user-attachments/assets/92821b4a-739c-458b-a1f3-1df0d64421ef)\n\n\n## Install \u0026 Enable Play Font\n\n### 1 install by bart42 (recommended, provide detailed version control \u0026 beta access)\n\n1. Install Brat plugin (if not yet)\n- search for BRAT\n- Install \u0026 enable BRAT\n2. Add Tab Flow plugin\n- Jump to Option\n- Add beta plugin\n```\nhttps://github.com/LIUBINfighter/Obsidian-Tab-Flow\n```\n- Select version \u0026 Add plugin\n3. Download missing assets\n- Open Tab Flow settingTab\n- Downding missing asset files\n- Reload Tab Flow plugin or Obsidian app\n\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/2a0052a2-d0a0-4d76-86ea-731d49d1902a\" /\u003e\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/80d9a66c-2d29-4c12-b5b7-76f4fca243d6\" /\u003e\n\u003c!-- \u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/6f89ad16-5206-4119-a42c-b5d35a19aa37\" /\u003e --\u003e\n\u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/6a4bc746-f292-4076-be1f-7c43192ba774\" /\u003e\n\u003c!-- \u003cimg width=\"2560\" height=\"1504\" alt=\"image\" src=\"https://github.com/user-attachments/assets/76a27078-f711-4f35-a9d2-23bae403ad56\" /\u003e --\u003e\n\n![download-assets](https://github.com/user-attachments/assets/b3ca9620-83df-4517-a005-fd0a3acba0c9)\n\n\nFor 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. \n\n\u003c!-- If you do concern about the assets loading, please refer to this Chapter Security and package using\n(Draft)--\u003e\n\nTab Flow plugin uses a npm package @coderline/alphatab [github repo](https://github.com/CoderLine/alphaTab), where the package content (font \u0026 sound font) comes from. We plan to provide other font resources when ready.\n\nCurrently 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 \u0026 release.\n\n### 2 download by github release \u0026 manual install\n\n\u003c!-- \u003cimg width=\"1946\" height=\"1278\" alt=\"image\" src=\"https://github.com/user-attachments/assets/685965d9-9718-480d-adac-171f00f3c65c\" /\u003e --\u003e\n\u003cimg width=\"1946\" height=\"1278\" alt=\"image\" src=\"https://github.com/user-attachments/assets/f6798b91-73d7-4543-8c28-61af013a7e0d\" /\u003e\n\nRelease `tab-flow.zip` contains assets in right dictory position, so there is no need to download assets and reload again.\n\n### 3 (Unable, currently in review queue) Obsidian Community Plugin Market\n\n[Click here](obsidian://show-plugin?id=tab-flow)  or search `Tab Flow` and enable it.\n\n## RoadMap\n\n- 0.3.x (we are here!) maintain\n- 0.4.x (work in progress) Refactor player and editor (React and Zustand), introduce alphaTex 2.0 when ready.\n- 0.?.x Not sure yet.\n- 1.0.0 Train a vlm for alphaTex ocr and integrate it in tab-flow.\n\n\n\u003c!--\n\n![alphatex-and-doc](https://github.com/user-attachments/assets/92821b4a-739c-458b-a1f3-1df0d64421ef)\n\n![alphatex-copy-and-paste-writing](https://github.com/user-attachments/assets/ef402b18-9c3f-4e10-8772-a3fd8e50c507)\n\n![alphatex-copy-and-paste-writing-multiview](https://github.com/user-attachments/assets/30d1e922-d4d2-4edd-a68a-8b2f3bada705)\n\n![download-assets](https://github.com/user-attachments/assets/b3ca9620-83df-4517-a005-fd0a3acba0c9)\n\n![visual-editor-playbar](https://github.com/user-attachments/assets/4fce8ba1-31fa-4ca5-ab78-d721374ce975)\n\n--\u003e\n\n\n## Contributing\n\nThanks for downloading this plugin and I appreciate it if you can help contribute!\n\nIf you have any feature requests / bugs to report, feel free to have an issue.\n\nIf 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.\n\n\u003c!-- If you want to add a new language to obsidian-tab-flow, see this guide first. --\u003e\n\n\u003c!-- ## How to Build --\u003e\n\n\u003c!-- ## Star History --\u003e\n\n\u003c!-- Star History Chart --\u003e\n\n## Inspired by ...\n\n[AlphaTab.js](https://alphatab.net)\n\nBocchi the rock!\n\nGirls' Band Cry\n\n## Disclaimer\n\nPlease 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.\n\nThis 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.\n\n\u003c!-- This plugin doesn't have official relationships with AlphaTab.js and Obsidian Official Team. --\u003e\n\n## Copyright \u0026 Credit\n\nCopyright (c) 2025 Jay Bridge and other contributors. All rights reserved.\n\nLicensed under the MPL 2.0 License.\n\n\n![Alt](https://repobeats.axiom.co/api/embed/a6982277492396e03c0cae7308592c2be2d0feb2.svg \"Repobeats analytics image\")\n\n## Special Thanks to\n\n![alphaTab logo](assets/alphaTab.svg)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliubinfighter%2Fobsidian-tab-flow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliubinfighter%2Fobsidian-tab-flow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliubinfighter%2Fobsidian-tab-flow/lists"}