> For the complete documentation index, see [llms.txt](https://docs.acestudio.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acestudio.ai/project/arrangement-in-canvas/clips/audio-warp.md).

# Audio Warp

Time-stretch audio clips with warp markers and align them to your project's tempo in ACE Studio.

## What Is Audio Warp

Audio Warp stretches or compresses an audio clip in time without changing its pitch. Place warp markers on the waveform and drag them onto the grid, or let ACE Studio align the clip to your project's tempo in one click.

Audio Warp lives in the Audio Editor. Double-click an audio clip to open it. For the other controls in the Audio Editor, please refer to [Clip Editor](https://docs.acestudio.ai/project/arrangement-in-canvas/clips/clip-editor.md).

## Turn Warp On

<figure><img src="https://3596338706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-75258220a860af950d23bc2a568e270191e8f5bf%2Faudio-editor-warp.png?alt=media" alt="Audio Editor with Warp turned on."><figcaption></figcaption></figure>

Warp is off by default for every imported or generated audio clip. Click **ON** next to **Warp** to turn it on.

When Warp is on:

* The first time you turn it on, a warp marker is created at the start of the clip.
* The detected beats and downbeats are shown above the waveform.
* Warp markers follow the project's musical time, so changing the project tempo re-warps the clip.

When Warp is off:

* The clip plays back unwarped, and project tempo changes do not affect it.
* Your warp markers are hidden but kept, and restored the next time you turn Warp on.
* If the unwarped audio is shorter than the clip, the clip end moves back to the end of the audio.

### Warp Mode

Choose how the audio is stretched from the **Warp Mode** menu:

* **General** – the default, for most material.
* **Solo** – for monophonic material such as a single voice or a lead instrument. Formant is unavailable in this mode.
* **Speech** – for spoken word. Pitch and Formant are unavailable in this mode.

## Warp Markers

A warp marker pins a point in the audio to a position on the timeline. Drag a marker, and the audio between it and the neighbouring markers is stretched or compressed, while the audio beyond the neighbouring markers stays in place.

### Create a Marker

* Double-click anywhere on the waveform. The marker is placed exactly where you click, without snapping.
* Hover over a detected beat or downbeat above the waveform and click the suggested marker.
* Right-click and choose **Insert warp marker**. Shortcut: <kbd>Ctrl</kbd>/<kbd>⌘Command</kbd> + <kbd>I</kbd>.

### Move a Marker

Drag a marker left or right. Markers snap to the project grid. Hold <kbd>Ctrl</kbd>/<kbd>⌘Command</kbd> while dragging to turn snapping off. A marker cannot be dragged past its neighbours.

* With several markers, dragging one only changes the audio between it and the adjacent markers. Audio outside the first and last markers moves along with them without stretching.
* With a single marker, dragging it slides the whole audio inside the clip. The clip's start and end on the timeline do not change.

### Select Markers

Click a marker to select it. Hold <kbd>Ctrl</kbd>/<kbd>⌘Command</kbd> and click to add markers to the selection, or hold <kbd>Shift</kbd> and click to select every marker in between.

### Delete a Marker

* Select the marker and press <kbd>Delete</kbd> or <kbd>Backspace</kbd>.
* Double-click an existing marker.
* Right-click the marker and choose **Delete warp marker**.

Choose **Reset all warp markers** from the right-click menu to clear all warp edits and start over with a single marker at the clip start.

### Set as Clip Start

Right-click a position and choose **Set as clip start** to make it the new start of the clip. The clip keeps its position on the timeline, and audio before this point no longer plays. A warp marker is placed at the new start. Existing markers are kept, including those outside the new range.

## Sync to Project

Click **Sync to Project** to align the clip to the project's tempo in one step. ACE Studio replaces the clip's warp markers with one marker on each detected downbeat, snaps the first downbeat to the nearest bar line, and lines the following downbeats up with the following bars. Warp is turned on automatically if it was off.

If the clip already has warp markers, ACE Studio asks for confirmation before overwriting them.

{% hint style="info" %}
Sync to Project needs detected downbeats. If none were detected in the audio, nothing changes and a message tells you so.
{% endhint %}

## Warp a Whole Clip on the Canvas

On the Canvas, dragging either end of an audio clip's title bar trims it. Hold <kbd>Shift</kbd> while dragging the end of the title bar to stretch or compress the whole clip proportionally instead. Existing warp markers keep their relative positions.

If Warp was off, it is turned on, previous warp edits are cleared, and the stretch starts from the unwarped audio.

## Beats, Downbeats and Tempo

ACE Studio analyzes the beats and downbeats of every imported or generated audio clip automatically. They are shown above the waveform while Warp is on, and are used for suggested markers, Sync to Project, and the clip's BPM.

* For audio of 1 minute or longer, the BPM is calculated when the clip is added. It is shown as **Analyzed BPM** below the Audio Editor and at the top right of the clip.
* For shorter audio, click **Analyze Tempo** below the Audio Editor to calculate it.

The BPM value is for reference only. It does not change the playback or the warping of the clip. If the analysis is off, you can edit the value by hand, or click the clear button next to it to remove it and return to the **Analyze Tempo** button. Beats, downbeats, and warp markers are not affected.

{% hint style="info" %}
Stems created by the Stem Splitter are split from the warped audio you hear. They inherit the clip's BPM, but start with Warp off and without warp markers.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.acestudio.ai/project/arrangement-in-canvas/clips/audio-warp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
