LMMS Wiki has been archived and it is now read-only. If you are interested in writing documentation or tutorials for LMMS, please move to https://docs.lmms.io/user-manual/.

Tool Bar

From LMMS Wiki
Jump to navigation Jump to search


The Tool Bar is shown permanently at the top of the window, underneath the Main Menu Bar. It looks like this:

Main-menu1.0.0 icons.png

The speed-bar buttons are arranged in 2 rows. The top row adress project-handling. The bottom row has buttons for toggling the different LMMS GUIs. We start with the top-row.

File Controls

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

  • Project new.png The Create New Project button creates a new project, using the default-template.
  • Project new from template.png The Create New Project From Template button will allow the use of own saved templates for new projects. By clicking on the icon you will see a list of templates you can load, this is mmpz files already filled with instruments, drums and/or automation. Templates can save you a lot of time! If you for example tend to remove all the four preloaded tracks in a new LMMS project, you could save a empty template and open that instead, each time you want to start on a new project.
  • Project open.png The Open Existing Project button opens a list of existing project files, inside your LMMS Working Directory.
  • Project open recent.png The Recently Opened Project button lists files that you have saved recently in LMMS. If you have opened a file and not saved it due to a crash or other similar circumstances, the file will not be in the list.
  • Project save.png The Save Current Project button saves the current project under the current project-name. If you have not yet saved the project you will be prompted for a name and save location.
  • Project export.png The Export Current Project button is a shortcut to exports of the current project as a WAV or OGG file. This is the same as in the file menu's Export option.

Window Controls

The seven buttons in the second row show or hide various workspace windows. When clicked, the action depends on the current state of that window. If the window selected, is not at the front of the LMMS window, it is brought to the front. If it is at the front, it is closed. If it is closed, it is opened and brought to the front. In other words: these are toggle buttons for the workspace windows. The contents of the window are not lost when the window is closed. These toggle-buttons allows you to work in a kind of 'tabbed' workspace. To utilize this feature, maximize all windows and use the toggle-buttons to bring your wanted window up infront.

All GUIs have a context menu icon in the top left corner of its window. Click the icon or use right mouse button to open the context menu. The Stay On Top option keeps that window on top of all other windows. This is especially useful for the FX-mixer, and also for some special tricks it allows you to do during song playback, such as real-time editing.

The Toggle buttons are:

  • Songeditor.png The Song-Editor toggle-button shows/hides the Song Editor.
  • Piano.png The Piano Roll Editor Window button shows/hides the Piano Roll Editor. If you click the toggle-button in an empty (new) project, an empty Piano-Roll window will open, and the message will be shown: "Please open a pattern by double-clicking on it!" You cannot edit in this window, because you opened a Piano-Roll editor window that is not linked to any track! You must close this orphaned window. However, Piano-roll windows that you open by double-clicking a block in the Song-Editor (or a segment in the Beat+Baseline Editor) will open the Piano-roll editor window linked to the track that you clicked in, and you can now edit its notes.
  • Automation.png The Automation Window button shows/hides the global-song Automation Editor window. Global-song automation is different from track-automation. You get access to global-song-automation by right-clicking a LMMS control, and then choose "Edit song-global automation", in the context-menu. This action will then open the Automation-Editor window, and you can create an automation-track that is specific to that control. Warning: there are no visual 'reminders' that you created this automation. In other words: if you decide to use "song-global-automation" you should definitely make a note of it in the project-notes window. A good habit is to name the automation track, and place it directly next to the track that it controls. Most "song-global-automation" is imported with MIDI-files. If a MIDI2-file has MIDI-automation, it will be "song-global-automation" inside LMMS!
  • Fx mixer.png The FX-mixer toggle-button shows/hides the FX-mixer.
  • Project notes.png The Project Notes button shows/hides the Project Notes window. These notes should be used to remind yourself of anything special in your project. For example: why you did things the way you did them, what you are going to do next, when the last edit was done, and something really important: Key and scale of the project! -Trust us.. You wont remember key & scale just one month after you made your composition.
  • Controller1.0.0.png The Controller-rack toggle-button shows/hides the Controller-rack; a list of lfo and peak controllers in the project.

You can also use the 'function-keys' to toggle the GUI-components up and down
From left to right:

  • F5 Song-Editor
  • F6 Drum & Beat-editor
  • F7 Piano-Roll
  • F8 Automation-Editor
  • F9 Mixer
  • F10 Project-Notes
  • F11 Controller-Rack

Tempo Control

Tempo-bpm 1.0.0.PNG The current tempo is shown in numerals. This is a standard control, so it can be changed by dragging up and down inside it and it can be automated by holding CTRL while dragging to an automation track. If some time the tempo seems to be stuck, it could be related to the global automation. By right clicking and choosing "remove song-global automation" the issue should be fixed.


Timer.png The timer shows the time it would take to play from the beginning of the song to the current position of playhead. Click on the timer to toggle it to show the number of bars, beats and ticks that have passed. Ticks subdivide beats, depending on the time-signature you have chosen. They are also important in automation, because you can snap the curve to ticks. In the 4/4 default time-signature, 32'th length notes, will snap to 2. tick of the beat. Swing-notes in percussion is also snapped to 2. tick, rather than to the beat.

Time Signature Controls

Time-sig 1.0.0.PNG The default time signature is 4/4. You can change this by dragging up or down and holding left mouse button. The separator in the Piano-roll will automatically adapt to the chosen time-signature. So what does a 'time-signature' actually means? The default 4/4 does not display this well. We need to look at a different time-signature before we can understand the numbers. 3/4 is also often used and we can use that as example. The '4' in this signature indicates what note length one beat has. So in both 4/4 and 3/4 signature, one beat is 1/4 note in length! The '3' denote how many beats there are in one bar. So in 4/4 we have 4 beats in one bar, but in 3/4, we have only 3 beats in one bar. You can read much more around time-signatures, and their importance in music here: http://www.musicarrangers.com/star-theory/t19.htm All that said - If your score suddenly look serious weird, and you cant make sense of anything, do check if you by chance have altered the time-signature.
Time-signature is also imported with MIDI-files, and can be hiding in song-global-automation.

Volume and Pitch Controls

To the right of the tempo control are the Master-volume and Pitch-controls.

Master volume 1.0.0.PNG The Master Volume control sets the master volume for the entire song. It is almost always a bad idea to change this from the default 100%.

Master pitch 1.0.0.PNG The Master Pitch control sets the 'root' note on which every other note in the song is based. Turn this down to make the piece play at a lower pitch, and vice versa. This can be useful if you have programmed a reproduction of a song to be in a certain key, and after checking it against the original, you find the original to be in a different key. But be careful, because there is a snag! Sound-clips can be messed up, when the master-pitch is changed, so it is not recommended.

Wave and CPU Usage Display

Wave CPU meter.PNG Finally, the Wave / CPU Display displays the current waveform being played during playback and the current CPU usage of all the LMMS instruments, effects and sequencing. You can turn the wave display off or on by clicking it, although this does little to reduce CPU usage, and it is a 'window' to the master output. You will see green curves, when you have no clipping. Orange curves when clipping is a risc, and red tells you that you need to address a clipping situation, in the mixer.


Prev: Main Menu Bar Up: Manual Next: Side Bar

Attribution. In addition to the history page this article is based on the previous article for the 0.4 series [1]