> For the complete documentation index, see [llms.txt](https://manual.minimal.audio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.minimal.audio/lucid-manual/granular-view/pitch-controls.md).

# Pitch Controls

### Overview

The **Pitch Controls** shape the pitch of every grain and keep it in key. Lucid detects and retunes each grain to your scale in real time, so you can transpose and modulate freely without falling out of tune, then use the chord and arp system to turn any sound into stacked harmonies and melodic sequences.

{% hint style="info" %}
Pitch detection works best on sources that play one note at a time, like vocals and leads. Lucid tracks a single pitch much like an auto-tuning effect, but on every grain. On chords or non-tonal material, no single pitch can be detected, so Lucid falls back to the scale's root note: still musical, just less precise.
{% endhint %}

![Pitch Controls.png](attachment:d81db2b2-e11b-4069-9385-d47f79876443:Pitch_Controls.png)

***

### Grain Pitch

Adjusts the pitch of each generated grain. The behavior of this control depends on the selected **Pitch Mode**.

In **Scale** mode, each grain is analyzed and retuned to the active scale in real time, allowing you to transpose and modulate pitch while remaining in key.

### Pitch Mode

Determines how grain pitch is processed.

* **Repitch:** Links pitch and playback speed, producing classic sampler and tape-style pitch shifting.
* **Free:** Shifts pitch independently of playback speed, preserving the original timing of the source audio.
* **Scale:** Detects and retunes each grain to the active scale in real time, allowing pitch changes that remain harmonically aligned with the selected key.

### Detune

Adds random pitch variation between individual grains.

At **0%**, all grains play at the selected Grain Pitch. Increasing the value introduces subtle to pronounced pitch variation, up to a full semitone above or below at 100%, creating chorus-like thickening and wider textures.

{% hint style="info" %}
Try moderate amounts with larger grain sizes to thicken your sound into lush, ensemble-like textures.
{% endhint %}

### Retune Mode

Controls how strongly grains are corrected to the active scale.

* **Off:** Disables pitch correction while still allowing Scale-based transposition to remain in key.
* **Smooth:** Applies gentle pitch correction for a more natural sounding result.
* **Hard:** Snaps each grain directly to the nearest scale note, producing a more pronounced pitch correction effect.

### Chord Mode

Determines how chord intervals are applied to generated grains.

* **Off:** Disables chord processing so all grains use the same pitch.
* **Arp:** Cycles through the active intervals one grain at a time. The playback speed follows the current Grain Rate, allowing tempo-synced arpeggios.
* **Chord:** Plays every active interval simultaneously, creating layered harmonic textures from each grain.

{% hint style="info" %}
Set the Grain Rate to a synced value in Arp mode to sequence arpeggios in perfect time with your\
track.
{% endhint %}

### Arp Randomize

Randomizes the playback order of intervals in **Arp** mode.

Lower values introduce occasional changes to the interval sequence, while higher values create increasingly unpredictable arpeggio patterns. Every interval is still played once before the sequence repeats.

### Chord Stereo Spread

Distributes chord voices across the stereo field.

At **0%**, all voices remain centered. Increasing the value alternates voices between the left and right channels, creating a wider stereo image while keeping the first voice centered when an odd number of intervals is active.

### Chord Interval

Sets the pitch offset for each arpeggio step or chord voice.

Values are measured in semitones for chromatic scales and in scale degrees for all other scales, ensuring intervals remain harmonically aligned with the selected key.

### Interval Active

Enables or disables an individual chord interval.

Disabled intervals are removed from stacked chords and skipped during arpeggiated playback, allowing you to reshape chords and sequences without changing the remaining intervals.

### Scale Note

Add or remove this note from the active scale.

The selected scale is shared throughout the plugin. Any parameter or mode that uses **Scale** will reference the notes enabled here, ensuring pitch-based processing remains in key.


---

# 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, and the optional `goal` query parameter:

```
GET https://manual.minimal.audio/lucid-manual/granular-view/pitch-controls.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
