> 📣 This is a plugin for the Joplin note-taking app.

VexTab Plugin for Joplin

A Joplin plugin for rendering guitar tablature using the VexTab API 🎼🎸

> What is VexTab?
>
> VexTab is a language that allows you to easily create, edit, and share standard notation and guitar tablature. Unlike ASCII tab, which is designed for readability, VexTab is designed for writeability.
>
> Source

How to use

1. Follow these instructions and install the plugin
2. Create a new note, or edit an existing note
3. Create a fenced block with the codetype joplin-plugin-vextab

#### Example

``joplin-plugin-vextab
tabstave notation=true key=A time=4/4

notes :q =|: (5/2.5/3.7/4) :8 7-5h6/3 ^3^ 5h6-7/5 ^3^ :q 7V/4 |
notes :8 t12p7/4 s5s3/4 :8 3s:16:5-7/5 :q p5/4
text :w, |#segno, ,|, :hd, , #tr
`

This will render the image below;

!VexFlow

$3

There are a few options you can pass into VexTab to customise its appearance.

- "scale": number
- "width": number
- "x": number
- "y": number

Write these as a JSON object after the token info;

#### Example

`joplin-plugin-vextab { "scale": 2, "width": 500 }
`

VexTab

- VexTab Tutorial
- VexFlow Google Group

Development

This plugin comes packaged with a distribution copy of VexTab 3.0.6

See the following GitHub issue

$3

npm run dist

$3

To update the plugin framework, run;

npm run update`