NAME

       harpwise - practice harmonica with your microphone and speaker

SYNOPSIS

       harpwise {MODE} {ARGUMENTS} [OPTIONS]

DESCRIPTION

       harpwise  ('wise'  for  short)  supports the daily practice of bends, scales, intervals or
       licks on a diatonic (richter) or chromatic harmonica for various keys.

       The wise recognizes single notes, that you play and it may play chords for you  (but  does
       not recognize your chords); rhythm is out of its scope entirely.

       The  primary  documentation of harpwise is its usage information, that can be retrieved by
       calling it without arguments:

              harpwise

       this man page has the very same information (so you may keep on reading  ...);  but  there
       are  more usage information for the individual modes, which are not available as man-pages
       (see below, on how to get them).

MODE

       When invoking harpwise, the first argument  on  the  commandline  specifies  the  mode  of
       operation; it can be one of:

       - listen: The wise listens to your playing, e.g. to monitor bends or scales

       - licks: Learn licks (only a few included, but pointers to find more)

       - quiz: Train your ear and musical memory

       And with a less interactive interface and not using your microphone:

       - play: Wise plays scales, holes or licks, not asking you to play them back

       - print:  print  and annotate the holes of scales or licks given on the commandline.  Also
         print various informationo about licks, scales and much more

       - tools: Some simple, non-interactive tools related to basic harmonica theory

       - calibrate: Wise generates samples for holes, or assists in recording your own; this is a
         prereq to using many other modes; you will be asked to invoke it, when necessary

       to  read  more  details,  usage examples and options for the individual modes, invoke them
       without arguments, e.g.

              harpwise listen

ARGUMENTS

       After the first argument (which specifies the  mode)  some  additional  arguments  may  be
       given:

       - type:  mostly  'richter'  or 'chromatic' but other choices might be defined. If omitted,
         this defaults to 'richter'.

       - KEY: key of harp, e.g. 'c' or 'g' or 'af' (a flat) or 'ds' (d sharp). If  omitted,  this
         defaults to 'c'.

       - SCALE:  scale  on  which  you  want  to concentrate, e.g. 'blues', 'major_pentatonic' or
         'all'. No default; cannot be abbreviated.

         Note, that most scales are notated in second position (e.g. key of g for a c-harp);  you
         may use the option --transpose-scale to change this.

         Finally, as a special case (and only for modes listen, quiz and licks) you may specify a
         set of holes (e.g. +1 +2 +3) as an adhoc scale.

         See the usage of mode 'listen' for an advanced example  involving  an  adhoc  scale  and
         fourth position.

       An example using all these arguments would be:

              harpwise listen richter c blues

       this  does listen to your playing, while marking notes from the blues-scale.  And, relying
       on defaults, this could also be written as:

              harpwise listen blues

       This example would listen especially for the first three notes of the  blues-scale,  which
       are given as arguments as an adhoc scale

         harpwise listen -2 -3 +4

       The possible scales depend on the chosen type of harmonica:

       scales for chromatic: all, blues, chord-i, chord-iv, chord-v, one, two
         scales for richter: all, blues, blues-middle, chord-i, chord-iv, chord-v,
           drawbends, major, major-pentatonic, mape, middle, minor, minor-pentatonic,
           mipe, mixolydian, root

OPTIONS

       Besides  the  arguments for type, key and scale, there are a lot of options (introduced by
       '-'), some requiring an argument themselves.  All options are described in the usage  info
       of the various modes.

       Most  arguments  and  options  can  be  abbreviated,  e.g  'lis'  for  'listen', 'cal' for
       'calibrate' or '-t' for '--tags-any'.

       Also note, that for most modes, the behaviour (e.g. the kind of display) of the  wise  can
       be changed interactively; type 'h' to see help on this.

SUGGESTED READING

       - Usage information for the individual modes

       - The toplevel file README.org, also available at:

         https://github.com/marcIhm/harpwise/blob/main/README.org

USER CONFIGURATION

       ~/.harpwise/config.ini

QUICK START

       Prepare your personal config with sound samples:

              harpwise calibrate c --auto

       Feedback on what you are playing:

              harpwise listen c

       then blow your harp and come back later to learn about other modes.

EXAMPLES

       See the usage information of the individual modes.

COPYRIGHT

       Copyright (c) 2021-2023 by Marc Ihm (marc@ihm.name)
       This program is subject to the MIT License.

SEE ALSO

       Again, the usage information of the individual modes.

                                                                                      harpwise(1)