1yoshimi(1)                  General Commands Manual                 yoshimi(1)
2
3
4

NAME

6       yoshimi - a software music synthesiser
7

SYNOPSIS

9       yoshimi [-option] [cmd]
10

DESCRIPTION

12       Yoshimi  is  a  polyphonic multi-part sound synthesiser utilising three
13       distinct 'engines' that can be used separately or together.  These  can
14       also  be  stacked  into 'kits', typically for percussion. It fully sup‐
15       ports both JACK and ALSA for MIDI input and audio output.
16
17       Yoshimi can be run in a graphical interface, a command line  interface,
18       or  with  control  from both. A number of controls can also be accessed
19       via MIDI. The CLI has its own Readline parser and built-in help  system
20       accessed by entering the commands '?' or 'help'.
21
22       The  CLI  help system is context sensitive, and apart from reminders of
23       common essential commands, only shows the relevant  commands.  However,
24       it is possible to specifically call for help from other contexts.
25
26       e.g.  Within  the  'part' context '? config' will show the commands for
27       configuration settings.
28
29       Yoshimi has a very extensive MIDI learn capability, exposing the major‐
30       ity  of  controls.  The  same MIDI CC and Channel pair can be linked to
31       multiple independent controls. There is  also  considerable  post-learn
32       editing capability.
33
34       Other  recent  extensions  are  the ability to import and export entire
35       instrument banks in a safe and obvious manner. It is now also  possible
36       to swap any instrument or bank with any other, in any bank root without
37       disrupting the rest of the structure.
38
39       One of the latest additions is the ability to  load  a  list  of  MIDI-
40       learned settings from the command line at startup.
41

COMMANDS

43       -?, --help Shows command syntax.
44
45       -a, --alsa-midi[=<device>] Use ALSA MIDI input.
46
47       -A, --alsa-audio[=<device>] Use ALSA audio output.
48
49       -b, --buffersize=<size> Set the internal buffer size.
50
51       -c, --no-cmdline Disable command line interface.
52
53       -C, --cmdline Enable command line interface.
54
55       -D, --define-root Define path to new bank root dir.
56
57       -i, --no-gui Disable graphical interface.
58
59       -I, --gui Enable graphical interface.
60
61       Attempting  'c' and 'i' will produce a warning, and although it is pos‐
62       sible to run with both disabled (accepting only MIDI) it is not  recom‐
63       mended.
64
65       -j, --jack-midi[=<device>] Use JACK MIDI input.
66
67       -J, --jack-audio[=<device>] Connect to JACK server.
68
69       -k, --autostart-jack Auto start JACK server.
70
71       -K, --auto-connect Auto connect to jack server.
72
73       -l, --load=<file> Load .xmz patch set.
74
75       -L, --load-instrument=<file> Load .xiz instrument file.
76
77       -M, --load-midilearn=<file> Load .xly learned list file.
78
79       -N, --name-tag=<tag> Add a tag to the client name.
80
81       -o, --oscilsize=<size> Set the AddSynth oscillater size.
82
83       -R, --samplerate=<rate> Set the ALSA audio sample rate.
84
85       -S, --state[=<file>]  Load previously saved state.
86              Defaults to "HOME/.config/yoshimi/yoshimi.state"
87
88       -u, --jack-session-file=<file> Load named JACK session file.
89
90       -U, --jack-session-uuid=<uuid> Use JACK session uuid.
91
92       Regardless of their position on the command line file loads will always
93       be in the order: session (or state), patch set, instrument, midi-learn
94
95       -V, --version Print Yoshimi version.
96
97       "Mandatory or optional arguments for long options are also mandatory or
98       optional for any corresponding short options."
99
100
101
102
103
104yoshimi 1.7.0.1                  January 2020                       yoshimi(1)
Impressum