## Settings

Some of these settings don't apply when running as an LV2 plugin, and mostly these are either hidden completely or shown as inactive.

### Main Settings

Internal Buffer Size Lower values will give lower latency and more accurate resolution, but at the cost of CPU loading. We recommend you keep this as low as possible without getting Xruns. AddSynth Oscillator Size The bigger this is the better the quality. However that is at the cost of CPU loading.
PadSynth Interpolation Relevant when transposing to notes far away from the nominal frequency of the wavetable. For those with good hearing at high pitches, setting this to 'Cubic' will give very slightly better results, but it is slower to operate.
PadSynth Wavetable Build Mode Wavetable build and application method.
Mute - disable part while wavetable is assembled. Unmute when ready to be applied.
Background - continue using old wavetable until new one is ready to be applied, use cross-fade.
Auto-Apply - automatically build new wavetable on changes. Fade to new one when ready.
Virtual Keyboard Layout You can have various standard layouts, when using the virtual keyboard, and this lets you select the most common.
XML Compression Level The degree of compression applied to saved data. Zero is useful for creating files readable in a text editor when checking for problems.
Send Reports to: Various text messages are created when Yoshimi is running. These can either be sent to a GUI Console window or to the standard command line output.
Console Text SizeThe font size used by the console is set independently of the window dimensions so that you can view varying amounts of text at whatever size is most convenient.
Saved Instrument Format Yoshimi instrument files can be saved to the original ZynAddSubFX format, the new extended Yoshimi format, or to both of them.
Mixer Panel Layout Depending on how you like to lay out your desktop you may want the default single row of 16 parts, or the more compact two rows of 8.

### Switches

Enable Bank Highlight This will highlight the last Instrument loaded from or saved to a bank. The highlight is retained through later bank changes, so you can still find the last one you handled. It will be lost though if you load an external file or patchset.
Start With Default State If a default state has been set this will be loaded on all startups and main resets.
Hide Non Fatal Errors Suppresses reporting of errors that aren't serious. This is especially useful for CLI users.
Show Splash Screen Enables or disables showing the startup splash screen. If disabled, then a very small message window is shown briefly so you know Yoshini has started.
Log Load Times Reports the time it took for an instrument to load, regardless of whether it was loaded externally, from a bank, or via MIDI. This helps you time dynamic loading in a running project.
Log XML Headers Reports an instrument's version number on loading. Both the ZynAddsubFX and Yoshimi numbers are displayed depending on whether it is an unedited original, a modified one or generated in Yoshimi from the start.
Include all data in XML files Originally, some data was not stored in ZynAddSubFX instruments. This meant there were sometimes subtle differences in the sound each time the instrument was loaded. This switch ensures all data is stored.
Enable GUI
Enable CLI These two switches determine which interfaces are active. You can deselect both, but in that case the only form of access to Yoshimi will be via MIDI.
Enable Auto Instance If this is enabled, then when you start Yoshimi, all instances that were open when it was last saved will be re-opened.
Enable Single Master If this is set, and you try to start a second copy of Yoshimi, then instead you will get a new instance from the running one. This is more efficient and makes better use of Yoshimi's resources.

### History Locks

All of the recent file lists can be locked so that their respective entries will not be moved or changed when you load or save new files of that type. This is particularly useful when using MIDI NRPNs to load files numerically via a remote keyboard/controller. It also makes loading frequently used files via the CLI more convenient.

### Jack

Jack MIDI Source This can be set if you know the name of a source you want to connect to, but usually it is left empty and connection made from the sender.
Set as preferred MIDI As described, sets this for MIDI input (disabling Alsa MIDI).
Jack Server It is possible to set a specific server if there is more than one active, but this is most unusual, so it is normally left as 'default'
Set as preferred audio Sets Jack for audio output, disabling access to Alsa audio
Autoconnect audio Connects to the current audio server when Yoshimi is started.

### Alsa

Alsa Connection Type By default sets 'Search' and will accept input from any Alsa sources it can find. Alternatively it can be set as 'Fixed, when you can use the option below. Finally it can be switched off, and connection is then made externally.
Alsa MIDI Source Used to set a comma separated list of sources you want to connect to.
Set as preferred MIDI Enables Alsa MIDI, disabling Jack input.
Alsa Audio Device The Alsa audio destination you want to connect to. If you don't set this Alsa will take over and set most of these parameters to 'safe' values.
Set as preferred audio Enables Alsa audio output, disabling connection to Jack.
Sample Rate Specific to Alsa, only a limited range of rates are supported - all the usual ones for high quality audio.

### MIDI

Bank Root Change Bank Change This pair of controls determine how Yoshimi responds to MIDI bank changes. Normally the Bank Root will be MSB (CC0) and Bank will be LSB (CC32), however some older hardware has these reversed. Also some devices send spurious changes, so not only can you swap them, you can also completely disable acting on them.
Enable Program Change Determines whether you want to allow Program/Instrument changes via MIDI from banks.
Enable Extended Program Change This lets you set a specific CC that will then perform program changes on the upper 32 instruments in a bank.
Extended Program Change CC This is the actual CC to use for extended program changes. The value sent should be the slot number of the wanted Instrument minus 128.
e.g. For loading the instrument at slot 130 you would send 2.
Enable Omni Mode Change Enables/Disables receiving Omni Mode messages. Such a message overrides the Omni setting in the Parts section, until it is reset.
Enable Incoming NRPNs Enables/Disables receiving NRPNs, but doesn't affect Vectors or MIDI Learn which are always available.
Ignore Reset all CCs Some devices send this command at inconvenient times, so, you can disable acting on it.
Log Incoming Events Reports the CC being received. Useful when you're not sure what (if anything) is being sent.
Show learn Editor If set, then on learning a control, or loading a state file that has learned entries, the MIDI Learn editing window will be opened.

### THEME

Recent versions of Yoshimi support user-defined colour themes. These are stored as plain text files in "/home/{user}/.local/share/yoshimi/themes". Initially there will be just two files; "classic.clr" and "demo.clr". You select these simply by clicking on the list entry. This will immediately perform the change. If you select anything other than the current default, the Current Theme box and Make Default button become active.
Classic is a duplicate of the internally generated normal style. This can be copied to a differently named one, then edited to your preference. Demo is a rather extreme example of what is possible. If you wish to develop your own themes you must follow the format exactly. If an error is seen Yoshimi reports the actual text line, and doesn't attempt any further lines.
Below are the first few lines from the 'classic' file:
Do not edit this. It may be overwritten. Instead, copy as template for other named themes. Don't add or remove lines between and including dashes. This would corrupt the colour map. ------------------ data start marker 0,255, Grey scale min-max (can be reversed) optional + R,G,B, (tint) 0,255,255, Panels (R,G,B or #rrggbb) 0,0,0, RESERVED 186,198,211, Knob shadow (#bac6d3) 231,235,239, Knob highlight (#e7ebef) 51,51,51, Knob ring 0,197,255, Knob ring lit
You can add three R,G,B values to the greyscale line which will give a colour tint to parts that have a grey content.
If you set the 'Monochrone' check box, the currently selected theme will be redrawn in shades of grey, as will all theme changes after that until such time as the button is unchecked. This is helpful for ensuring your theme is usable by anyone who is colour blind. The setting is never saved.
Further details can be found in the Advanced Reference Manual
With the 'Import' button you can also fetch themes that have been downloaded from elsewhere. These will be immediately loaded and displayed in the theme list. Alternatively with the 'Export' button you can make a copy of the current theme to a more accessible location.
With a suitable text editor pointed to "/home/{user}/.local/share/yoshimi/themes" you can edit any theme - apart from 'classic'. If this is the currently selected one and you have the theme editor visible, your changes will show immediately. Back to top