Documentation Wiki rss-feed







Fingerer is an Agent that enables the player to take a small incoming group of keys (normally from a Keygroup) and use those to play a wide chromatic range in a monophonic (one note) style. This will be a familiar concept to all players of wind instruments and Fingerer comes with a number of predefined fingerings suitable for players who are familiar with traditional woodwind and brass.

It provides options to add both modifiers (which tell the Scaler downstream to move a note off of it's scale, using the modifier increment for that scale, usually a semitone), additions (which tell the Scaler to change the note played by an increment on the scale) and polyphony modifiers which may add new notes to play alongside the base note, also defined in scale increments.

Players may move between fingerings in a smooth manner as each fingering is not treated as a simple on or off. As each fingering becomes more fully keyed it becomes more significant and its chosen note is weighted more heavily. Fingerings that are effective sub fingerings of another are suppressed in their effect depending upon how well keyed the larger fingering is. A fully keyed pattern totally suppresses all smaller patterns.

This means that one can effectively slide smoothly between fingerings and even to use a partially activated fingering to allow for vibrato. The player can adjust this behaviour to be more or less significant by changing the Key Paremeter Maximum as shown below.

Fingerings are highly flexible and the player may define their own using a text editor. There is a User Fingerings file that can modified and added to by the player. This is described in more detail here: User Fingerings.

The Factory Fingerings file can be viewed here: link:Factory Fingerings.txt


Breath Parameter Activation Threshold

134 8731 1435 1148
breath parameter activation threshold

  • Input, Set
  • Type: Number
  • Range: 0 to 1.0
  • Default: 0.001

The value set here determines at what value of the incoming breath signal the Fingerer starts a new note on it's output. This may be raised to make the Fingerer less sensitive to low value breath inputs.

Key Parameter Maximum

114 8731 2342
key parameter maximum

  • Input, Set
  • Type: Number
  • Range: 0 to 1.0
  • Default: 0.1

The value determines the key pressure value that Fingerer takes as a fully depressed key. Turning it up towards 1.0 will make it progressively harder to finger keys fully but will give greater control while transitioning between fingerings, turning it down will make it easier to achieve a clean full fingering but will make it harder to expressively move from fingering to fingering. Turing it down to a very low value will result in Fingerer behaving like conventional electronic wind instruments equipped with switches instead of Eigenkeys as fingerings will be either on or off with little in between.

Key Parameter Threshold

114 8731 1148
key parameter threshold

  • Input, Set
  • Type: Number
  • Range: 0 to 1.0
  • Default: 0

The value determines the key pressure value that Fingerer takes as a starting point for deciding if a key is pressed. Turning it up above zero will simply make the keys less sensitive to light touches. The entire key is taken to go from off to fully depressed between this threshold and the key parameter maximum.



  • Input, Set
  • Type: Text
  • Range: Available fingerings

The value determines the current fingering that the Fingerer is using. It must be one of the fingerings defined in either the supplied Factory Fingerings or the user defined User Fingerings file (please see above for this).


A fingering can be changed by two means, either using Belcanto or by using Workbench.

Changing a fingering using Belcanto

This example assumes that you have one Fingerer called 'Fingerer 1'.

8885 11 5
fingerer 1 hey
8886 23 2175 2176 67
fingering to tin whistle set

This will change the fingering for Fingerer 1 to 'tin whistle'.

Changing a fingering using Workbench

Open the Fingerer Agent that you wish to change the fingering for by clicking on the left hand side, if it is not already open. You will see a list of ports, one of which will be called 'fingering'. Select the edit tool. Using the edit tool, click on the 'fingering' port. Then click on the side of the box which contains the fingering and you should see a list of available fingerings:

image:Setting fingering.png

Select the fingering you wish to use, click on the 'Set' button and it will take effect. Note that if you are working on your own fingering in the User Fingerings file it is worth checking to make sure that EigenD has not raised an error window telling you about any syntax error you might have made, before you proceed.