** Overview of 'harpwise listen'

  The mode 'listen' shows information on the notes you play; depending
  on settings for display and comment this can be:

    - Hole
    - Note
    - Membership of played note in various scales
    - Interval to previous note
    - Difference to a reference note, e.g. to practice bends
    - Speed of warbles

  When playing, you may switch on journal to get a simple
  transcription of the holes played.


** Usage by Examples:

  The wise listens, while your are playing a richter harp of key c and
  it shows the holes, that you played; green if from the blues-scale,
  blue otherwise:

    #+begin_src 
    harpwise listen richter c blues
    #+end_src

  The same, but relying on the defaults for type (richter) and key (c):

    #+begin_src 
    harpwise listen blues
    #+end_src

  The same, but also showing the notes from the one-chord (chord-i):

    #+begin_src 
    harpwise listen blues --add-scales chord-i --display chart-scales
    #+end_src


  If you want to follow the chord-progression of a 12-bar blues, you may try

    #+begin_src 
    harpwise listen --scale-progression 12bar
    #+end_src

  to switch from one chord to the next, every time you press 's'.

  To use the RETURN-key, which might be easier to hit, you may try:

    #+begin_src 
    harpwise listen --scale-prog 12bar --keyboard-translate RETURN=s
    #+end_src

  or use (shorter) '--kb-tr TAB=s' to employ the TAB key. And you may
  also make this option durable in your config.ini.

  If, in addition to the scale-progression, you want one or more licks
  at hand (e.g. turnarounds), you may give them as an adhoc
  lick-progression:
  
    #+begin_src 
    harpwise listen --scale-prog 12bar --lick-prog simple-turn,wade
    #+end_src


  As an advanced example, assume that you would like to play the minor
  pentatonic scale in fourth position. However, harpwise only knows it
  in second position (i.e. starting on -2).

  How would you move this scale from second to fourth position?

  The first step would be to get the notes of the minor-pentatonic
  scale:

    #+begin_src 
    harpwise print mipe
    #+end_src

  then take those notes and shift them from second to fourth position
  by moving up two fifths up in the circle of fifths.

  And because a fifth is 7 semitones (you may check this via: harpwise
  print intervals), this would be 2 * 7 = 14 semitones.

  In addition one would move one ocatve (= 12 semitones) down to reach
  the lower end of the harp (for more expressiveness): 14 - 12 = 2
  semitones.

  So we would have to shift the notes of the minor pentatonic scale by
  2 semitones to get from second to fourth position:

    #+begin_src 
    harpwise tools shift +2st -2 -3/ +4 -4 -5 +6
    #+end_src

  Using the resulting holes as an adhoc scale for listen, we would be
  able to tell harpwise, that we want to play the minor pentatonic in
  fourth position:

    #+begin_src 
    harpwise listen -3// +4 -4 +5 +6 -6
    #+end_src

  However, you could get the same effect also like this:

    #+begin_src 
    harpwise listen mipe --transpose-scale +2st
    #+end_src

  which uses the fact (as explained above), that moving two positions
  up are just two semitones.


  Finally, as a quite technical note: If you find harpwise sluggish or
  if you get a warning on lagging and lost samples, you may want to
  experiment with --time-slice:

    #+begin_src 
    harpwise listen c --time-slice short
    #+end_src

** Quick Start

    #+begin_src 
    harpwise listen c              
    #+end_src
