NAME

       yoshimi - a software music synthesiser

SYNOPSIS

       yoshimi [-option] [cmd]

DESCRIPTION

       Yoshimi  is a polyphonic multi-part sound synthesiser utilising three distinct 'engines' that can be used
       separately or together. These can also be  stacked  into  'kits',  typically  for  percussion.  It  fully
       supports both JACK and ALSA for MIDI input and audio output.

       Yoshimi  can  be  run  in  a  graphical interface, a command line interface, or with control from both. A
       number of controls can also be accessed via MIDI. The CLI has its own Readline parser and  built-in  help
       system accessed by entering the commands '?' or 'help'.

       The  CLI  help  system  is context sensitive, and apart from reminders of common essential commands, only
       shows the relevant commands. However, it is possible to specifically call for help from other contexts.

       e.g. Within the 'part' context '? config' will show the commands for configuration settings.

       Yoshimi has a very extensive MIDI learn capability, exposing the majority of controls. The same  MIDI  CC
       and  Channel  pair  can be linked to multiple independent controls. There is also considerable post-learn
       editing capability.

       Other recent extensions are the ability to import and export  entire  instrument  banks  in  a  safe  and
       obvious  manner.  It is now also possible to swap any instrument or bank with any other, in any bank root
       without disrupting the rest of the structure.

       One of the latest additions is the ability to load a list of MIDI-learned settings from the command  line
       at startup.

COMMANDS

       -?, --help Shows command syntax.

       -a, --alsa-midi[=<device>] Use ALSA MIDI input.

       -A, --alsa-audio[=<device>] Use ALSA audio output.

       -b, --buffersize=<size> Set the internal buffer size.

       -c, --no-cmdline Disable command line interface.

       -C, --cmdline Enable command line interface.

       -D, --define-root Define path to new bank root dir.

       -i, --no-gui Disable graphical interface.

       -I, --gui Enable graphical interface.

       Attempting  'c'  and  'i'  will  produce a warning, and although it is possible to run with both disabled
       (accepting only MIDI) it is not recommended.

       -j, --jack-midi[=<device>] Use JACK MIDI input.

       -J, --jack-audio[=<device>] Connect to JACK server.

       -k, --autostart-jack Auto start JACK server.

       -K, --auto-connect Auto connect to jack server.

       -l, --load=<file> Load .xmz patch set.

       -L, --load-instrument=<file> Load .xiz instrument file.

       -M, --load-midilearn=<file> Load .xly learned list file.

       -N, --name-tag=<tag> Add a tag to the client name.

       -o, --oscilsize=<size> Set the AddSynth oscillater size.

       -R, --samplerate=<rate> Set the ALSA audio sample rate.

       -S, --state[=<file>]  Load previously saved state.
              Defaults to "HOME/.config/yoshimi/yoshimi.state"

       -u, --jack-session-file=<file> Load named JACK session file.

       -U, --jack-session-uuid=<uuid> Use JACK session uuid.

       Regardless of their position on the command line file loads will always be  in  the  order:  session  (or
       state), patch set, instrument, midi-learn

       -V, --version Print Yoshimi version.

       "Mandatory  or  optional  arguments for long options are also mandatory or optional for any corresponding
       short options."