Skip to content

Commit

Permalink
add extra whistle instrument files
Browse files Browse the repository at this point in the history
  • Loading branch information
jon gadsden committed Jan 9, 2023
1 parent 7bd9df1 commit 1717911
Show file tree
Hide file tree
Showing 4 changed files with 395 additions and 21 deletions.
60 changes: 58 additions & 2 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,7 @@ 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).
plugin will adjust the tab diagram position for the lowest note possible.

See the "Here be Dragons" section of this document that discusses various
quirks related to early MuseScore 3 releases.
Expand Down Expand Up @@ -116,3 +115,60 @@ 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.

## Extra Tin Whistle and Low Whistle Tunings
The files `all-whistles.xml` and `all-whistles-v4.xml` are extra instrument files
for adding both High Tin Whistle types and Low Whistle types to MuseScore.
MuseScore comes with whistles D, C and B♭ by default but you may want to use other tunings.

The High Tin Whistle, which is a metal 6 hole Flageolet, comes in various tunings.
These are listed in order of decreasing physical size:
* "B♭ Tin Whistle" tuned to key B♭, also used for keys Cm and E♭
* "C Tin Whistle" tuned to C, also for Dm and F
* "D Tin Whistle" tuned to D, also for Em and G
* "E♭ Tin Whistle" tuned to E♭, also for Fm and A♭
* "F Tin Whistle" tuned to F, also for Gm (F can be played on a C whistle)
* "G Tin Whistle" tuned to G, also for Am (G can be played on a D whistle)

Tuning to D is by far the most common, so "Tin Whistle" is the same as "D Tin Whistle".

The Low Whistle is larger than the more well-known tin whistle and has a lower pitch.
This whistle is commonly available in three tunings:
* "D Low Whistle" tuned to D4, also used for keys Em and G
* "F Low Whistle" tuned to F4, also used for Gm and B♭
* "G Low Whistle" tuned to G4, also used for Am and C

### Install for extra whistles
The file `all-whistles.xml` or `all-whistles-v4.xml` needs to be installed using the MuseScore menu.

#### Install for MuseScore 4.x
Download the `all-whistles-v4.xml` instrument extension file to your operating system.

1. Start Version 4.x Musescore
2. use the drop down menus to navigate 'MuseScore' then 'Preferences...' then 'Score' panel
3. Use the file icon beside 'Score Order List 2:' to select the downloaded `all-whistles.xml` file
4. Accept the changes using the OK button

You can now add a tin/low whistle staff to your score using the 'Instruments' tab and 'Add' button.
Note that these whistles appear in the 'World Music' genre, not the 'Common' genre.

#### Install for MuseScore 2.x and MuseScore 3.x
Download the `all-whistles.xml` instrument extension file to your operating system.
Use the same file for both MuseScore version 2.x and version 3.x :

1. Either MuseScore 2.x: copy file `all-whistles.xml` to `Documents/MuseScore2/Extensions/all-whistles.xml`
2. Or for MuseScore 3.x: copy file `all-whistles.xml` to `Documents/MuseScore3/Extensions/all-whistles.xml`
3. within Musescore menu, navigate to 'MuseScore' then 'Preferences...' then 'Score' tab
4. in the Default Files panel, add the file to 'Instrument List 2' extension by:
5. browsing to `Documents/MuseScore3/Extensions/all-whistles.xml` and add to 'Instrument List 2'
6. Accept the changes with the OK button

You may now add a tin whistle staff using MuseScore menu item 'Edit' then 'Instruments...',
where MuseScore lists these extra instruments under 'World Music' 'Woodwinds'.

Once a tin whistle staff is added to the score there is no need to keep the instrument
file `all-whistles.xml` in the 'Instrument List 2' extension.

## Examples

The score `examples/tin_whistle_range_test.mscz` is an example showing all the High Tin Whistle staves.
The score `examples/low_whistle_range_test.mscz` shows all three Low Whistle staves.
179 changes: 179 additions & 0 deletions all-whistles-v4.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,179 @@
<?xml version="1.0" encoding="UTF-8"?>
<museScore>
<InstrumentGroup id="woodwinds">
<name>Woodwinds</name>
<Instrument id="bflat-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>B♭ Tin Whistle</longName>
<shortName>B♭ Wh.</shortName>
<traitName type="tuning">B♭</traitName>
<description>Tin Whistle pitched in B♭, Cm and E♭</description>
<musicXMLid>wind.flutes.whistle.tin.bflat</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>70-94</aPitchRange>
<pPitchRange>70-100</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="c-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>C Tin Whistle</longName>
<shortName>C Wh.</shortName>
<traitName type="tuning">C</traitName>
<description>Tin Whistle pitched in C, Dm and F</description>
<musicXMLid>wind.flutes.whistle.tin.c</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>72-96</aPitchRange>
<pPitchRange>72-102</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="d-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>D Tin Whistle</longName>
<shortName>D Wh.</shortName>
<traitName type="tuning">D</traitName>
<description>Tin Whistle pitched in D, Em and G</description>
<musicXMLid>wind.flutes.whistle.tin.d</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>74-98</aPitchRange>
<pPitchRange>74-104</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="common-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>Tin Whistle</longName>
<shortName>Tin Wh.</shortName>
<traitName type="tuning">D</traitName>
<description>Tin Whistle pitched in D. The most common variant.</description>
<musicXMLid>wind.flutes.whistle.tin.common</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>74-98</aPitchRange>
<pPitchRange>74-104</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="eflat-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>E♭ Tin Whistle</longName>
<shortName>E♭ Wh.</shortName>
<traitName type="tuning">E♭</traitName>
<description>Tin Whistle pitched in E♭, Fm and A♭</description>
<musicXMLid>wind.flutes.whistle.tin.eflat</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>75-99</aPitchRange>
<pPitchRange>75-105</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="f-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>F Tin Whistle</longName>
<shortName>F Wh.</shortName>
<traitName type="tuning">F</traitName>
<description>Tin Whistle pitched in F, Gm and B♭</description>
<musicXMLid>wind.flutes.whistle.tin.f</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>77-101</aPitchRange>
<pPitchRange>77-107</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="g-tin-whistle">
<family>whistles</family>
<trackName>Tin Whistle</trackName>
<longName>G Tin Whistle</longName>
<shortName>G Wh.</shortName>
<traitName type="tuning">G</traitName>
<description>Tin Whistle pitched in G, Am and C</description>
<musicXMLid>wind.flutes.whistle.tin.g</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>79-103</aPitchRange>
<pPitchRange>79-109</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="d-low-whistle">
<family>whistles</family>
<trackName>Low Whistle</trackName>
<longName>D Low Whistle</longName>
<shortName>D Wh.</shortName>
<traitName type="tuning">D</traitName>
<description>Low Whistle pitched in D, Em and G. The most common variant.</description>
<musicXMLid>wind.flutes.whistle.low</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>62-86</aPitchRange>
<pPitchRange>62-92</pPitchRange>
<Channel>
<!--MIDI: Bank 0, Prog 78; MS General: Whistle-->
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="f-low-whistle">
<family>whistles</family>
<trackName>Low Whistle</trackName>
<longName>F Low Whistle</longName>
<shortName>F Wh.</shortName>
<traitName type="tuning">F</traitName>
<description>Low Whistle pitched in F, Gm and B♭</description>
<musicXMLid>wind.flutes.whistle.low</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>65-89</aPitchRange>
<pPitchRange>65-95</pPitchRange>
<Channel>
<!--MIDI: Bank 0, Prog 78; MS General: Whistle-->
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="g-low-whistle">
<family>whistles</family>
<trackName>Low Whistle</trackName>
<longName>G Low Whistle</longName>
<shortName>G Wh.</shortName>
<traitName type="tuning">G</traitName>
<description>Low Whistle pitched in G, Am and C</description>
<musicXMLid>wind.flutes.whistle.low</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>67-91</aPitchRange>
<pPitchRange>67-97</pPitchRange>
<Channel>
<!--MIDI: Bank 0, Prog 78; MS General: Whistle-->
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
</InstrumentGroup>
</museScore>
146 changes: 146 additions & 0 deletions all-whistles.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,146 @@
<?xml version="1.0" encoding="UTF-8"?>
<museScore>
<InstrumentGroup id="woodwinds">
<name>Woodwinds</name>
<Instrument id="bflat-tin-whistle">
<longName>B♭ Tin Whistle</longName>
<shortName>B♭ Tin Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys B♭, Cm and E♭</description>
<musicXMLid>wind.flutes.whistle.tin.bflat</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>70-94</aPitchRange>
<pPitchRange>70-100</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="c-tin-whistle">
<longName>C Tin Whistle</longName>
<shortName>C Tin Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys C, Dm and F</description>
<musicXMLid>wind.flutes.whistle.tin.c</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>72-96</aPitchRange>
<pPitchRange>72-102</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="d-tin-whistle">
<longName>D Tin Whistle</longName>
<shortName>D Tin Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys D, Em and G</description>
<musicXMLid>wind.flutes.whistle.tin.d</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>74-98</aPitchRange>
<pPitchRange>74-104</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="common-tin-whistle">
<longName>Tin Whistle</longName>
<shortName>Tin Wh.</shortName>
<description>metal 6 hole Flageolet, most commonly tuned to D</description>
<musicXMLid>wind.flutes.whistle.tin.common</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>74-98</aPitchRange>
<pPitchRange>74-104</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="eflat-tin-whistle">
<longName>E♭ Tin Whistle</longName>
<shortName>E♭ Tin Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys E♭, Fm and A♭</description>
<musicXMLid>wind.flutes.whistle.tin.eflat</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>75-99</aPitchRange>
<pPitchRange>75-105</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="f-tin-whistle">
<longName>F Tin Whistle</longName>
<shortName>F Tin Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys F, Gm and B♭</description>
<musicXMLid>wind.flutes.whistle.tin.f</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>77-101</aPitchRange>
<pPitchRange>77-107</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="g-tin-whistle">
<longName>G Tin Whistle</longName>
<shortName>G Tin Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys G, Am and C</description>
<musicXMLid>wind.flutes.whistle.tin.g</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>79-103</aPitchRange>
<pPitchRange>79-109</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="d-low-whistle">
<longName>D Low Whistle</longName>
<shortName>D Low Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys D, Em and G</description>
<musicXMLid>wind.flutes.whistle.low.d</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>62-86</aPitchRange>
<pPitchRange>62-92</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="f-low-whistle">
<longName>F Low Whistle</longName>
<shortName>F Low Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys F, Gm and B♭</description>
<musicXMLid>wind.flutes.whistle.low.f</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>65-89</aPitchRange>
<pPitchRange>65-95</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
<Instrument id="g-low-whistle">
<longName>G Low Whistle</longName>
<shortName>G Low Wh.</shortName>
<description>6 hole Flageolet, metal construction, keys G, Am and C</description>
<musicXMLid>wind.flutes.whistle.low.g</musicXMLid>
<clef>G8va</clef>
<barlineSpan>1</barlineSpan>
<aPitchRange>67-91</aPitchRange>
<pPitchRange>67-97</pPitchRange>
<Channel>
<program value="78"/> <!--Whistle-->
</Channel>
<genre>world</genre>
</Instrument>
</InstrumentGroup>
</museScore>
Loading

0 comments on commit 1717911

Please sign in to comment.