Plugin icon

VexTab plugin for Joplin

Description

A Joplin plugin for rendering guitar tablature using VexTab

Additional Information

Links:
Maintainers: francospeziali
Version:0.1.2
Minimum app version:2.8
Downloads: This version:98
Last updated:2023-06-14T19:07:08Z

📣 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