Skip to content

A Joplin plugin for rendering guitar tablature using the VexTab API

License

Notifications You must be signed in to change notification settings

WeMakeMachines/joplin-plugin-vextab

Repository files navigation

📣 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

Customising

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

Development

This plugin comes packaged with a distribution copy of VexTab 3.0.6

See the following GitHub issue

Building the plugin

npm run dist

Updating the plugin framework

To update the plugin framework, run;

npm run update

About

A Joplin plugin for rendering guitar tablature using the VexTab API

Resources

License

Stars

Watchers

Forks

Packages

No packages published