Skip to content

MuseScore plugin to add tablature / finger diagrams to a tin whistle staff in a score

License

Notifications You must be signed in to change notification settings

cbjeukendrup/tin-whistle-tablature

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tin-whistle-tablature

MuseScore plugin to add tablature / finger diagrams to a tin whistle staff in a score

Introduction

This provides a plugin to automatically add fingering / tab diagrams to the notes in scores for tin whistle. The plugin will adjust for tin whistles tuned to D, C and Bb, according to the instrument defined for each staff. Note that if the staff instrument is not a whistle then no tabs are applied, otherwise the plugin will adjust the tab diagram position for the lowest note possible (currently D, C or Bb).

See the "Here be Dragons" section of this document that discusses various quirks related to early MuseScore 3 releases.

Installation

  • If using MuseScore 3 (version 3.4 or later) then download the plugin and unzip it.

  • If using MuseScore version 3.3 or earlier then download this plugin.

  • Alternatively if using the older MuseScore version 2 then download this plugin.

  • Install using the instructions in the MuseScore 3.x Handbook, which typically involves copying the QML file to the local MuseScore Plugin directory. If you are using MuseScore version 2.x then use this handbook instead.

  • Open MuseScore and navigate to 'Plugins' -> 'Plugin Manager' to enable the plugin. Tick the box against 'tin_whistle_tablature' and apply with 'OK'.

  • This plugin relies on a tin whistle tablature font being installed. Note that the font is not included in this download but can be obtained from Blayne Chastain's site. If the font isn't installed you will be presented with a message box telling you how to obtain the font. To install the font, it is usually just a case of double-clicking the downloaded .ttf file and agreeing to the install process. If that does not work then on linux systems try copying the TinWhistleTab.ttf font file to the /usr/share/fonts/truetype/ directory. However, if you are installing the font on a Windows 10 system you will need to ensure you install the font for "all users". You can do this by right clicking on the file and selecting "Install for all users" as illustrated here:

Image of installing font for all users

For more information on this Windows 10 font problem and solutions see issue musescore/MuseScore#6084 and how-to-force-win10-to-install-fonts-in-c-windows-fonts.

Using the plugin

The tabs will be added to the highlighted bars if you have made a selection, otherwise the whole score will have tabs added. Here is an example score before applying the tabs:

Diagram of tin whistle score before applying tabs

When you wish to apply the tabs then navigate to 'Plugins' -> 'Tin Whistle' -> 'Add tablature'. Here is the score with the tabs now applied:

Diagram of tin whistle tabs applied to the score version 3

and the equivelent if using MuseScore 2 :

Diagram of tin whistle tabs applied to the score version 2

You can back out by navigating to 'Edit' -> 'Undo'.

Other stuff

MuseScore Plugin API compatibility: 2.x

Issues: https://github.com/jgadsden/tin-whistle-tablature/issues

MuseScore issue tracker: https://musescore.org/en/project/issues/TinWhistleTablature

License: https://github.com/jgadsden/tin-whistle-tablature/blob/main/LICENSE

Download version 3 plugin from: https://github.com/jgadsden/tin-whistle-tablature/archive/main.zip

Download the older version 2 plugin from: https://github.com/jgadsden/tin-whistle-tablature/archive/version2.zip

Code repository: https://github.com/jgadsden/tin-whistle-tablature/

There are two branches for this plugin in the code repository: one for MuseScore 2.x on a branch 'version2' and the other for Musecore 3.x on the 'main' branch.

Here be Dragons

The version for MuseScore 2 will check that the staff is for a tin whistle and adjust the tab diagram position for the lowest note possible.

Prior to MuseScore 3.2:

  • The instrument type used on a staff can NOT be detected. In this case the plugin will assume that a whistle tuned to D is used - this being the most common whistle.

  • This plugin only supports grace notes that lead the main note. Tabs for trailing grace notes will be rendered as leading notes which is not what you want. In fact the trailing notes will be out of order.

Prior to MuseScore 3.3:

  • You may see some minor issues with grace note tab positioning. The actual physical position of the grace notes was not available before v3.3 so a heuristic approach (aka good 'ole human observation) is used to get a decent overall result even though it's not perfect.

Here is an example of how the fingering tab images are accurately positioned in MuseScore 3.3+:

Image of test cases for grace notes.

Having problems?

Note that this plugin relies on a font being installed, see the Installation instructions.

The plugin will skip any staffs that are not for a Tin Whistle, so for example if the staff is for the Irish Flute then it will not apply the tabs. This makes sense as other instrument's fingering will be different.

About

MuseScore plugin to add tablature / finger diagrams to a tin whistle staff in a score

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • QML 100.0%