> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lmms.io/user-manual/en/utilities/microtuner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.