Skip to content

LIUBINfighter/Tabst.app

Repository files navigation

Tabst

Write guitar tabs like markdown.

中文README

DOI CI Release Downloads (Total) Downloads (Latest)

image

Features

Write. Play. Share.

Efficiently write alphaTex. Play scores. Share PDF/GP.

  • Desktop: browse public Tabst DB scores through a dedicated Cloud workspace without signing in.
  • Web (play.tabst.app): append public Tabst DB scores into the Sandbox workspace so they can be browsed with the normal file tree and player flow.

Why Tabst

Say no to bulky binaries and XML; the world belongs to plain text.

While document writing already has a plethora of out-of-the-box Markdown editors, precise typesetting tools like LaTeX, and innovative tools like Typst, why in the realm of guitar tabs are we still connecting notes on scores like in Word?

MusiXTeX and Lilypond have set a publishing-grade example in music notation languages, while alphaTab.js has made interactive and playable scores possible. In Tabst, we write alphaTex in a simple, intuitive syntax, and easily share with your friends.

This is just the beginning. The vision is to make guitar tab writing as effortless as writing markdown.

Tech Stack

Development Environment

MCP Server

Install Deps

pnpm install

Development

pnpm run dev  # Run React development server + Tauri shell
pnpm run dev:react # Run renderer only

Build Targets

pnpm run build        # Default desktop build (Tauri)
pnpm run build:web    # Website target (static dist)
pnpm run build:tauri  # Explicit Tauri desktop build

Release

pnpm run release
pnpm run release:mac
pnpm run release:linux
pnpm run release:win

Desktop Runtime

The desktop runtime cutover is complete and the repository is now Tauri-first.

  • Product builds, release commands, and CI desktop validation all target Tauri.
  • The renderer uses a unified desktopAPI bridge for desktop capabilities.
  • Desktop now includes a read-only Cloud workspace mode: the left sidebar lists public Tabst DB scores, and the selected score reuses the normal Editor/Preview split in read-only form.
  • Detailed normalization work and follow-up tasks are tracked in docs/dev/TAURI_MIGRATION_STATUS.md.

Web Runtime Notes

  • play.tabst.app keeps the existing Sandbox repo model as the primary web workspace.
  • On web initialization, public Tabst DB scores are imported into the Sandbox workspace as .atex files and refreshed by at.meta.source, so repeated visits update existing imported public objects instead of duplicating them.
  • The web flow is intentionally public-only. There is no sign-in, private-library, or publish flow in the current website adaptation.

About

Write guitar tabs like markdown. Powered by alphaTab.js.

Topics

Resources

License

Stars

25 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors