# The Lathe guide

Everything Lathe does, one task at a time: setting it up, recording, arranging, mixing, sharing a song and working with an AI assistant. New to Lathe? Start with **Getting started**, then **A tour of the window**.

![Lathe with the Night Drive demo song open: the transport along the top, tracks and clips in the middle, and the selected track's plug-ins and EQ at the bottom.](https://getlathe.app/img/docs/docs-window.jpg)

## Start here

| Page | What's in it |
|---|---|
| [Getting started](https://getlathe.app/docs/getting-started.md) | Installing, the first launch, your audio interface, plug-ins and templates |
| [A tour of the window](https://getlathe.app/docs/tour.md) | What each part of Lathe's window is for |

## Make a song

| Page | What's in it |
|---|---|
| [Arranging](https://getlathe.app/docs/arranging.md) | Tracks and clips: selecting, moving, copying, splitting and joining, the loop, track groups |
| [Recording](https://getlathe.app/docs/recording.md) | Arming, count-in, latency, recording one track into another, recording a note generator |
| [MIDI and the piano roll](https://getlathe.app/docs/midi.md) | Writing and editing notes, importing and exporting MIDI files |
| [Instruments and effects](https://getlathe.app/docs/devices.md) | Lathe's own synths, drums and effects, your VST3 plug-ins, and the plug-in browser |
| [Mixing](https://getlathe.app/docs/mixing.md) | The mixer, routing, sends and returns, group buses, monitor mixes and the channel EQ |
| [Compare and Undo History](https://getlathe.app/docs/compare-and-undo.md) | Hearing what a change did, and going back to any step |
| [Exporting](https://getlathe.app/docs/exporting.md) | Mixes and stems in WAV, AIFF, FLAC, MP3 or Ogg |

## With other people

| Page | What's in it |
|---|---|
| [Lathe Cloud](https://getlathe.app/docs/lathe-cloud.md) | Sharing songs, push and pull, history, comments, invite and listening links |
| [The AI assistant](https://getlathe.app/docs/ai-assistant.md) | Letting an AI app read, play, build and mix your session |
| [Note notation](https://getlathe.app/docs/notation.md) | The short text form the assistant writes and reads parts in |

## Reference

| Page | What's in it |
|---|---|
| [Keys and mouse](https://getlathe.app/docs/keys.md) | Every shortcut in one table |
| [Performance](https://getlathe.app/docs/performance.md) | Processing cores, buffer size, the CPU meter and the benchmark |
| [Project files](https://getlathe.app/docs/project-files.md) | What's in a project folder, saving, autosave and recovery |
| [Updating Lathe](https://getlathe.app/docs/updating.md) | Lathe Patcher and the automatic update check |

## For contributors

These pages are about Lathe's code rather than using it, and live on GitHub: the [code map](https://github.com/taddeimania/lathe/blob/main/docs/code-map.md), [multi-core audio](https://github.com/taddeimania/lathe/blob/main/docs/multicore.md) and a planned refactor, [explicit state machines](https://github.com/taddeimania/lathe/blob/main/docs/state-machines.md).

These pages live with Lathe's code: a change that alters how Lathe behaves updates its page in the same commit. The pictures are drawn by Lathe itself from a demo song each time the site is published, so they always show the current version.
