> For the complete documentation index, see [llms.txt](https://docs.lmms.io/user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lmms.io/user-manual/en/utilities/microtuner.md).

# Microtuner

The Microtuner Configuration window can be accessed through [Edit](/user-manual/en/navigation/menu-bar.md#edit-menu) > Scales and Keymaps.

<figure><img src="/files/t7wAJv2uS1WZkCWANacB" alt=""><figcaption></figcaption></figure>

The Microtuner allows changing various scales and keymaps.&#x20;

This configuration is then written into the project file when saved. To change the configuration to modify something globally so it shows up in every project henceforth, you will need to edit your default template.

It can save and load scala scale files (`.scl`) and scala keymap definitions (`.kbm`). It is similar to the ZynAddSubFX microtuner.

{% hint style="info" %}
The microtuner configuration dialogue box can only change and edit scales and keymaps, not necessarily apply them to the tracks.\
**To actually make an instrument track use a different scale/keymap**, the microtuner needs to be enabled and appropriately set up in the Tuning and Transposition tab of the track's instrument window.
{% endhint %}

## Scale

The left-hand side of the Microtuner Configuration window allows modification of scales.

**Scale slot to edit**: This drop-down selects the scale slot which is loaded into the microtuner for usage and editing.

**Scale name**: This textbox allows changing the name of the scale that is being used. It does not change the name of the scale slot.

File operations: **Load** allows loading a scala scale file into the microtuner. **Save** allows saving the current scale configuration of the microtuner as a scala scale file.

### Format

The scale format is described [here](https://www.huygens-fokker.org/scala/scl_format.html).

Every line represents the notes of the scale as relative to the basenote frequency.

Any value with a period is a cent value that describes how many cents above the basenote the note is.

Any ratio or integer is a fraction that describes the ratio of the frequency of the note to the basenote.

## Keymap

The right-hand side of the Microtuner Configuration window allows modification of keymaps.

**Keymap slot to edit**: This drop-down selects the keymap slot which is loaded into the microtuner for usage and editing.

**Keymap name**: This textbox allows changing the name of the keymap that is being used. It does not change the name of the keymap slot.

File operations: **Load** allows loading a scala mapping (.kbm) file into the microtuner. **Save** allows saving the current mapping configuration of the microtuner as a scala mapping (.kbm) file.

**Keymapping parameters**: These parameters, accessible on the right hand side on the lower corner, control various parameters of the keymap such as base note, MIDI range, etc.

### Format

The mapping format is described [here](https://www.huygens-fokker.org/scala/help.htm#mappings).

## Apply scale changes / Apply keymap changes

These buttons apply the changes on a given scale/mapping in the microtuner configuration to any instruments or tracks using the scale/mapping. Without pressing this button, changes aren't transferred onto instruments even if their microtuner configuration is enabled.