# Toolbar

The toolbar is located at the top of the LMMS interface underneath the Main Menu bar.

![Toolbar](/files/-LubXTgYzKhqG66h-i-3)

The toolbar has four sections:&#x20;

* On the left hand side are two rows of buttons which can be controlled by clicking and keyboard shortcuts.&#x20;
  * The buttons are arranged in 2 rows. The top row contains buttons that handle the project (**file controls**). The bottom row has buttons that toggle the different  windows of the LMMS GUI (**window controls**).
* In the center are three numerical displays for a **timer**, **tempo controls**, and **time signature controls**.&#x20;
* To the right of the numerical displays are two sliders, one for **master volume** and the other for **master pitch**.
* To the far right is a **Wave and Cpu usage display** which shows the current audio waveform being played and CPU usage.&#x20;

## File Controls

The six buttons in the top row deal with opening and saving files.

* <img src="/files/-LubXipHSAJQUcoTUzas" alt="" data-size="original">The **Create New Project** button creates a new project.
* <img src="/files/-LubYWZFjqgak7xBQNkZ" alt="" data-size="original">The **Create New Project From Template** button creates a new project using a selected template.
* <img src="/files/-LubY7jHekA8507vc-cn" alt="" data-size="original">The **Open Existing Project** button opens an existing project file from your LMMS Working Directory (you are also able to point to other directories).
* <img src="/files/-LubYlPUvHtUNxNtEVdo" alt="" data-size="original">The **Recently Opened Project** button lists files that you have saved recently. You can then choose a project to open from this list.
* <img src="/files/-LubYu2E3UcbMFI3OF0U" alt="" data-size="original">The **Save Current Project** button saves the current project. If you have yet to save the current project, you will be asked to name it and select a directory to store it in.
* <img src="/files/-LubZ4Mq6QIO4K_Vm5s6" alt="" data-size="original">The **Export Current Project** button is a shortcut to export the current project as a .wav, .ogg, or .mp3 file (.flac is also avaliable for export as of 1.3).&#x20;
  * This opens the same dialog box as the file menu's Export option.

## Window Controls

The seven buttons in the second row show or hide various workspace windows. These are toggle buttons for the workspace windows, allowing you to work in a tabbed GUI.&#x20;

The toggle buttons are:

* <img src="/files/-LubZGPrK_Z8_yr6Tr8B" alt="" data-size="original">The **Song-Editor** toggle button shows/hides the Song Editor.
* <img src="/files/-LubZRAqmu5lJrbk_7nk" alt="" data-size="original">The **Beat+Bassline Editor** button shows/hides the Beat+Bassline Editor.
* <img src="/files/-LubZcIrI1YQ1Ep_b-Ec" alt="" data-size="original">The **Piano Roll Editor Window** button shows/hides the Piano Roll Editor. (Must be linked to a Piano Roll Clip before it can be used)
* <img src="/files/-LubZuLx8p7LwpVPn8zJ" alt="" data-size="original">The **Automation Window** button shows/hides the global-song Automation Editor window.&#x20;
* <img src="/files/-Lub_6j-Awwtbeu0rmU3" alt="" data-size="original">The **FX-Mixer** toggle-button shows/hides the FX-Mixer.
* <img src="/files/-Lub_KtvQlfaARK0babi" alt="" data-size="original">The **Project Notes** button shows/hides the Project Notes window.
* <img src="/files/-Lub_Sfgzc08R84oqsjm" alt="" data-size="original">The **Controller-rack** toggle button shows/hides the Controller-rack.

These buttons can be toggled on or off by clicking or by using keyboard shortcuts. The keyboard shortcuts are as follows, from left to right:

* Song-Editor (F5)
* Beat & Bassline Editor (F6)
* Piano-Roll (F7)
* Automation-Editor (F8)
* Mixer (F9)
* Project-Notes (F10)
* Controller-Rack (F11)

As of LMMS 1.3, the shortcuts are:

* Song-Editor (Ctrl+1)
* Beat & Bassline Editor (Ctrl+2)
* Piano-Roll (Ctrl+3)
* Automation-Editor (Ctrl+4)
* Mixer (Ctrl+5)
* Project-Notes (Ctrl+7)
* Controller-Rack (Ctrl+6)

In addition to these toolbar controls, all windows have a margin from which a Context Menu can be opened:

* **Stay On Top** keeps that window on top of all other windows.
* **Maximize** displays that window in fullscreen if possible.
* **Move** makes the window follow the cursor until the left mouse button is pressed.
* **Size** resizes the window (following the cursor) until the left mouse button is pressed.

## Tempo Control

![Tempo control](/files/-Lub__mSQk1gRWBRkWO0)

The tempo control displays the current tempo of the song.  The tempo can be adjusted in three ways:&#x20;

* By left-clicking on the numerical display and, while continuing to hold the left mouse button down, moving the mouse up or down.
* By left-clicking on the numerical display and, while continuing to hold the left mouse button down, rolling the mouse wheel up or down.
* By double-clicking on the numerical display, a window will open which will allow you to type in a new numerical value for the tempo.

The tempo can also be automated like any other parameter.

## Timer

![Timer](/files/-Lub_qwaxAk8yNUa1lUn)

The timer shows the time from the beginning of the song to the current position of play-head. Clicking on the timer toggles it to instead show how many bars, beats, and ticks from the beginning of the song to the current position of the play-head. (Ticks subdivide beats, depending on the time-signature you have chosen.)&#x20;

## Time Signature Controls

![Time signature controls](/files/-Luba1fh0kUfR4XjUJbw)

The default **time signature** is 4/4. You can change the time signature by holding the left mouse button down on the value you wish to change and dragging up or down with the mouse. You can also double-click to open a window which will allow you to type in a new value.&#x20;

{% hint style="info" %}
The top number dictates the number of beats per measure, and the bottom number dictates the value (eighth, sixteenth, etc.) of each beat.
{% endhint %}

## Master Volume and Pitch Controls

To the right of the tempo control are the master volume and pitch controls.

<img src="/files/-LubaBdJt5Ipz51ySirL" alt="" data-size="original">The **Master Volume** control sets the master volume for the entire project.

<img src="/files/-LubaJyu1H8JFXxUy8gv" alt="" data-size="original">The **Master Pitch** control transposes all instruments except those with the Master Pitch toggle disabled.

Both are controlled by holding the left mouse button down on the slider and dragging it up or down with the mouse.&#x20;

## Wave and CPU Usage Display

![Wave and CPU usage display](/files/-LubaT7Ixq8fhB2Cv3jy)

The **Wave/CPU display** shows both the current waveform being played and the current CPU usage of all LMMS instruments, effects, and sequencing. You can turn the wave display off or on by left-clicking it. When it is disabled, it will read "Click to enable".\
For the waveform display color:&#x20;

* Green indicates no clipping
* Orange indicates clipping is a risk
* Red indicates clipping


---

# Agent Instructions: 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/navigating-lmms/toolbar.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.
