# Notes editor

JJazzLab embeds a Midi notes editor which is used to [**edit user tracks**](#edit-a-user-track) or [**song part custom phrases**](#edit-a-custom-phrase-for-a-song-part)**.**

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FgrKhTdmA2w2DBmHtgYis%2F2024-12-30%2011_01_51-JJazzLab%20%204.1.2.png?alt=media&#x26;token=a7335211-526a-43b5-9dc4-b2dcdd451fac" alt=""><figcaption><p>Melodic track. Below is the velocity panel.</p></figcaption></figure>

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FzjFGIobo5mkdr4Yc3gUG%2F2024-01-01%2000_06_53-JJazzLab%20%204.0.2.png?alt=media&#x26;token=7787699f-cd59-44f9-abf9-f9c833e6306b" alt=""><figcaption><p>Drums track</p></figcaption></figure>

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FZlp7nnguvSHezwv2QGgX%2F2024-12-30%2013_30_36-JJazzLab%20%204.1.2.png?alt=media&#x26;token=26a535ed-a909-43a0-a013-09f4612df9aa" alt=""><figcaption><p>Below is the simplified score panel (non-editable)</p></figcaption></figure>

## Opening the notes editor

### Edit a user track

The notes editor is automatically opened when you [add a user track](https://jjazzlab.gitbook.io/user-guide/mix-console#adding-user-tracks). For existing user tracks, click the edit button in the track overview component, as shown below.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FjIQjTdbv9JVsXfu2bEvl%2F2023-12-31%2022_02_16-JJazzLab%20%204.0.2.png?alt=media&#x26;token=e3c43e03-77a6-4ead-8108-81851fde0baf" alt=""><figcaption></figcaption></figure>

Rhythm tracks can also be edited with the notes editor by cloning them first as a user track :

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FXtIjuOJRd47u5V20ILjE%2F2023-12-31%2021_58_28-JJazzLab%20%204.0.2.png?alt=media&#x26;token=b49c7f81-e3e3-4597-87aa-e63e53cda4ac" alt=""><figcaption></figcaption></figure>

### Edit a Custom phrase for a song part

In the song structure editor, click the top-left button of a Custom phrase rhythm parameter:

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FnqKB5ii27HoGUxiUTBJQ%2F2024-01-05%2012_40_44-JJazzLab%20%204.0.2.png?alt=media&#x26;token=c41bfda6-15c9-4971-b7e2-6894c8423b32" alt=""><figcaption></figcaption></figure>

Then select the phrases you wish to customize and press Edit to open the notes editor.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FcUi59UxSR59QUmuNkUI9%2F2024-01-05%2011_52_05-Customize%20phrases%20for%20song%20part%20_A_%20-%20bars%201..8.png?alt=media&#x26;token=95ad792e-200d-450a-84f0-29262aa1dea5" alt=""><figcaption></figcaption></figure>

## Moving and zooming

You can move the editor by pressing **ctrl + dragging** in the top ruler as shown below:

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FW2T2ygEphFitSHTXdcsk%2F2024-01-01%2000_12_51-JJazzLab%20%204.0.2.png?alt=media&#x26;token=9b263bc2-5a2f-4e41-87cb-89965ec2803e" alt=""><figcaption></figcaption></figure>

You can use the main application zoom sliders in the lower right corner, or use **ctrl+mouse-wheel** for horizontal zoom, **ctrl+shift+mouse-wheel** for vertical zoom.

Use **ctrl-F** to zoom to fit width.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FPXXkeYD06d0bIcO5BDLZ%2F2023-12-31%2023_37_35-JJazzLab%20%204.0.2.png?alt=media&#x26;token=5ffbbe64-eb6d-45c6-ba8d-00f8dce08d3b" alt=""><figcaption></figcaption></figure>

## Playback controls

Use the toolbar button shown in the image below, or press **ctrl-shift-SPACE,** to play **in loop mode** the edited phrase, or the [playback loop zone](#playback-loop-zone) if it is set.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2F3ILnYIphMhTfnXgKjvrF%2F2024-05-16%2022_49_35-JJazzLab%20%204.0.3-SNAPSHOT.png?alt=media&#x26;token=4f9c8c0c-20d0-4cfe-97bd-5601fd2255d1" alt=""><figcaption><p>Start playback button</p></figcaption></figure>

Press **ctrl-SPACE** to start playback :

* from the [playback loop zone](#playback-loop-zone) if it is set
* from the bar of the first selected note
* if no note selected, from the first visible bar

Other controls:

<div><figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FwkluM8RqhoEjxcxnNhf6%2FNoteEditor-soloButton.png?alt=media&#x26;token=bc07be29-be06-41dd-b896-be7b1406920c" alt=""><figcaption></figcaption></figure> <figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2F0HhjkNq6IiAXMAxmkr9X%2FNoteEditor-autoscroll.png?alt=media&#x26;token=68e3f781-2559-4b8a-a210-4226dce2055f" alt=""><figcaption></figcaption></figure> <figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2Fqry31tqERYvSEnTOgX1v%2FNoteEditor-Hear.png?alt=media&#x26;token=a26a1010-956f-46d4-941d-42dc7f823fa8" alt=""><figcaption></figcaption></figure></div>

### Playback loop zone

A playback loop zone can be set by **mouse dragging** in the top **ruler**. Use **shift+click** in the ruler to extend the loop zone. **Click** in the ruler to remove the loop zone.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2Fg5vyRXg5MpN10Rtp0gm7%2F2024-05-16%2022_47_02-JJazzLab%20%204.0.3-SNAPSHOT.png?alt=media&#x26;token=9cb4b66c-0c65-4f5e-88d5-84eb45a9c95d" alt=""><figcaption></figcaption></figure>

Use the toolbar button (see above) of press **ctrl-shift-spac**e to start playing the loop zone.

## Snap to grid

Use the **Snap to grid** button (or press **G**) to snap notes to the grid when you draw/move/resize them. The size of the grid can be set using the drop-down list (1/4=quarter note, 1/8=quaver, ...):

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FX9EWFO9XDXOWJMKt3Ie5%2F2023-12-31%2023_20_16-JJazzLab%20%204.0.2.png?alt=media&#x26;token=b55f5c28-0e20-412e-a82d-c07605b9731f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
When you move or resize notes with the **Select tool**, you can temporarily reverse the "snap to grid" setting by pressing **alt**.
{% endhint %}

To change the position of existing notes, use [Quantize](#quantize-notes).

## Edit tools

You can use 3 tools to modify notes: **select tool**, **draw tool**, **erase tool**. The 2 first edit tools are sensitive to the [snap to grid](#snap-to-grid) settings.

Tools can be selected using buttons from the notes editor top toolbar, or by right-clicking in the editor:

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FBpLRlFoLXZGr7iEvzedR%2F2023-12-31%2023_14_25-JJazzLab%20%204.0.2.png?alt=media&#x26;token=6d559455-9f8e-4f70-af34-0d14bd896101" alt=""><figcaption></figcaption></figure>

Use the **select tool** to select, move, resize, copy/cut (**ctrl-C/X**), delete notes (press **Delete**).

Use **ctrl-V** to paste notes.

{% hint style="danger" %}
How to control at which position notes are pasted ?

* If a note is selected, the first pasted note is aligned with that selected note
* If no notes selected, the first pasted note is aligned to the left side of the notes editor

The new pasted notes are automatically selected, so you can move them to the appropriate position if required.
{% endhint %}

**Drag** to select several notes. Use **ctrl-drag** notes to duplicate notes. **ctrl-shift-I** invert the notes selection.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FSztqeDDC9iDLZjWAmRNB%2F2023-12-31%2023_25_52-JJazzLab%20%204.0.2.png?alt=media&#x26;token=15a32187-07e8-4b9b-85fb-8e56712d9717" alt=""><figcaption></figcaption></figure>

Use the **draw tool** to draw notes, and the **erase tool** to erase notes.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FPYBIysaCk69hOYQNQXHw%2F2024-01-01%2000_16_08-JJazzLab%20%204.0.2.png?alt=media&#x26;token=cdbd3d1c-b39d-4275-887f-7c845a9a83aa" alt=""><figcaption></figcaption></figure>

## Changing notes velocity

Notes color vary with their velocity. There are several way to change notes velocity, as shown below.

#### Using the main editor panel

First select the notes to change. Then either use the velocity spinner in the toolbar, or use **alt + mouse-wheel** or **alt + page up/down**.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FHF6ODlvoRCJZ8UYn5lOZ%2F2023-12-31%2023_29_11-JJazzLab%20%204.0.2.png?alt=media&#x26;token=2cb4f994-2a95-4aa6-bfb5-9901a58add8f" alt=""><figcaption></figcaption></figure>

#### Using the velocity panel

**Click** or **mouse-drag** on notes to adjust their velocity.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FRcgl5TSkv0m2VIDAPoYY%2F2024-12-30%2011_04_48-JJazzLab%20%204.1.2.png?alt=media&#x26;token=791476da-abb4-47cd-b61b-cc699b59e431" alt=""><figcaption></figcaption></figure>

## Quantize & humanize notes

Use the **Quantize** button or press **Q** to move the selected notes start position on the current grid. If no note selected, all notes are quantized.

Check the **Iterative** box to perform iterative quantize : notes are gradually moved towards the grid. This is usually recommended to avoid a too mechanical sound.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FXUw608C4tsBMkIgHdLQy%2F2024-01-01%2000_28_31-JJazzLab%20%204.0.2.png?alt=media&#x26;token=2adfad40-b20f-4a43-8743-5d459653534e" alt=""><figcaption></figcaption></figure>

You can also **humanize** all or selected notes. Humanization introduces slight random variations in the notes start position and velocity. Use the **Humanize** button on the left, or press **ctrl-H** to show the Humanize dialog.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FcX0r65yn2CWSS2ghqOyk%2F2024-05-16%2023_10_38-JJazzLab%20%204.0.3-SNAPSHOT.png?alt=media&#x26;token=29a44f71-4f4e-459b-8ac6-faf989417dea" alt=""><figcaption></figcaption></figure>

Once you clicked the Humanize button, you can adjust the humanization parameters and see the different results.

#### Example

This bass line is very uniform: all notes have the same velocity and are quantized. This sounds too "robotic".

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FscG7tbKRUHIePZLJMtuJ%2F2024-12-30%2011_40_40-JJazzLab%20%204.1.2.png?alt=media&#x26;token=2a1fe4e3-34ee-44d5-b57b-680264f22cae" alt=""><figcaption></figcaption></figure>

We can use the Humanize dialog to improve this, as shown below.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2FUTVLnc1g9cjUSezwYp0V%2F2024-12-30%2011_41_33-JJazzLab%20%204.1.2.png?alt=media&#x26;token=ac9a1b03-3026-4cdb-81d3-13c8ebb9acf9" alt=""><figcaption></figcaption></figure>

## Simplified score panel

This panel shows a **simplified musical notation:** notes positions are just aligned with the editor notes, without any embellishment.

The score panel is **NOT** editable.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2F1JkK6ACtnjD07s0IFcR1%2FScorePanel.png?alt=media&#x26;token=9099c79e-b907-456b-aa5b-5ca5e327b154" alt=""><figcaption><p>Simplified score panel below the piano roll</p></figcaption></figure>

Use the **Octave** display transposition if notes are too low or too high to be seen in the score panel. This only impacts the display in the panel, notes are not actually transposed.

## Importing notes

You can import notes by dragging an external Midi file into the editor. You can also drag from an individual track in the mix console.

<figure><img src="https://1057949908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQE7B7yjVY3xzlsorS4-887967055%2Fuploads%2F9aAie8nbhntkLS0ENh0j%2F2023-12-31%2022_54_43-JJazzLab%20%204.0.2.png?alt=media&#x26;token=c8e36b3d-2412-42da-8f98-1d25f2c830e8" alt=""><figcaption><p>Importing a Midi file in the editor</p></figcaption></figure>

{% hint style="warning" %}
If the imported Midi file contains notes from several Midi channels, then JazzLab **only imports the notes which match the editor Midi channel.**

If the imported Midi file only contains notes from a single channel, then JJazzLab imports the notes with the channel updated to the editor Midi channel.
{% endhint %}

## Mouse shortcuts

<table data-header-hidden><thead><tr><th width="253.33333333333331">Selection</th><th>Mouse</th><th>Action</th></tr></thead><tbody><tr><td>Notes</td><td>ctrl-click</td><td>select multiple notes</td></tr><tr><td>Editor</td><td>drag</td><td>select multiple notes</td></tr><tr><td>Notes</td><td>drag</td><td>move/resize</td></tr><tr><td>Notes</td><td>ctrl-drag</td><td>duplicate notes</td></tr><tr><td>Notes</td><td>alt-drag</td><td>move/resize with snap-to-grid setting reversed</td></tr><tr><td>Notes</td><td>alt-wheel</td><td>change velocity</td></tr><tr><td>Editor</td><td>wheel</td><td>move editor up down</td></tr><tr><td>Editor</td><td>shift mouse-wheel</td><td>movbe editor left right</td></tr><tr><td>Editor</td><td>ctrl mouse-wheel</td><td>zoom in/out horizontally</td></tr><tr><td>Editor</td><td>ctrl-shift mouse-wheel</td><td>zoom in/out vertically</td></tr><tr><td>Editor</td><td>ctrl-drag</td><td>Move editor</td></tr><tr><td>Ruler</td><td>drag</td><td>set playback loop zone</td></tr><tr><td>Ruler</td><td>shift-click</td><td>extend playback loop zone</td></tr><tr><td>Ruler</td><td>click</td><td>remove playback loop zone</td></tr></tbody></table>

## Keyboard shortcuts

| Selection | Key              | Action                                                   |
| --------- | ---------------- | -------------------------------------------------------- |
| Notes     | alt-up/down      | change velocity                                          |
| Notes     | ctrl-C/X/V       | copy/cut/paste notes                                     |
| Notes     | delete           | delete notes                                             |
| Notes     | ctrl-shift-I     | invert notes selection                                   |
| Notes     | ctrl-H           | open humanize dialog                                     |
| Notes     | Q                | quantize selected notes (or all no selection)            |
| Editor    | ctrl-F           | zoom to fit notes                                        |
| Editor    | G                | snap-to-grid                                             |
| Editor    | A                | auto-scroll during playback                              |
| Editor    | S                | solo the edited phrase                                   |
| Editor    | H                | hear the selected notes                                  |
| Editor    | Home/End         | Move editor to start/end                                 |
| Editor    | ctrl-shift-space | play the loop zone (if set) or whole phrase              |
| Editor    | ctrl-space       | play from loop zone (if set) or from first selected note |
| Editor    | ctrl-Z/Y         | undo/redo                                                |
