Skip to content

From a file to a finished album.

DAWN has three layers: a TypeScript SDK that describes a song, a CLI that checks, renders and measures it, and an album command that runs the whole path for several songs at once. Everything runs on your machine.

1. A song is a project of files.

dawn init creates a project with a song.ts. The song sets tempo, meter, key and sections, and lists its tracks. A track names an instrument and its notes, which you write out or build from grooves, sequences and chord progressions.

song.ts
import { pattern, progression, seq, song, track } from "dawn";

export default song({
  tempo: 120,
  meter: [4, 4],
  bars: 8,
  key: "A minor",
  sections: [
    { name: "Verse", startBar: 0, bars: 4 },
    { name: "Chorus", startBar: 4, bars: 4 },
  ],
  tracks: [
    track({ name: "Drums", instrument: "kit", rhythm: pattern("house") }),
    track({
      name: "Bass",
      instrument: "bass",
      notes: seq("A1 . A1 . F1 . G1 . A1 . A1 . F1 . G1 .", {
        step: 2,
        len: 0.7,
      }),
    }),
    track({
      name: "Keys",
      instrument: "piano",
      notes: progression("i VI III VII i VI III VII", { key: "A minor" }),
    }),
  ],
});

The SDK guide covers instruments, effects, automation and arrangement.

2. The CLI checks and renders it offline.

dawn check type-checks the project and evaluates the score. dawn render writes a WAV, a MIDI file or score JSON. Rendering never opens an audio device, and the same score always renders to the same bytes.

Terminal
$ dawn check
ok · 3 tracks, 226 notes · types 3645 ms · eval 106 ms
$ dawn render first-light.wav --measure
rendered · first-light.wav · 16.35 s · 22050 Hz (--rate 48000 for full band) · 1442226 bytes · 7acb10b0…
loudness · -12.8 LUFS · momentary max -12.3 · short-term max -12.6 · LRA 0.1 LU · -2.7 dBTP · PLR 10.1

--measure reads the render back: integrated loudness, true peak, loudness range and band balance. dawn lint checks the score against writing rules before anything renders.

Output from the first-song guide’s project. Timings vary by machine. The default render is 22,050 Hz; --rate 48000 renders the full band.

3. One command makes an album.

dawn album reads a brief: a title, a seed, a song count and a mix of archetypes. The same brief makes the same album.

brief.json
{
  "title": "Small Hours",
  "seed": 11,
  "songs": 3,
  "mix": { "banger": 2, "ballad": 1 }
}
Terminal
$ dawn album brief.json --out album

It works through nine stages, in order:

plan
A groove, tempo, key, form and theme for each song, so no two songs are alike.
compose
Each song is written as a project you can open and edit.
words
The sung lines, one syllable a note: from the built-in bank, or a local model.
sing
The stock voice sings every song before anything renders.
render
A raw render of each project.
mix
Levels and EQ are solved against the song's mix gates.
master
The mix at its loudness target, with its measurements.
gate
Each master is read against its gates. A song that fails is made again.
report
What was made, what was read and every attempt, in one file.

Every stage is cached. --resume picks up a stopped run, and --stage stops after the stage you name.

4. A song that fails is made again.

The gate stage reads each master against the gates for its archetype: loudness, tonal balance, stereo, vocal balance and how many of the sung words a speech recognizer hears back. A song that fails is made again, up to --redo times (two by default). The composer is told which gate failed and by how much, and changes only what answers it.

Terminal
$ dawn album brief.json --out album
…
gate 01-small-machine: FAIL sm_16k -6.76 (-6.53..0.53) · recall 0.828
gate 02-night-drive: pass · 48 gates · recall 0.715
gate 03-glass-weather: pass · 48 gates · recall 0.675
redo 01-small-machine: attempt 2 of at most 3 · composed again with a new seed
…
gate 01-small-machine: pass · 48 gates · recall 0.82
redo 01-small-machine: kept attempt 2 of 2 · pass · 48 gates · recall 0.82

From a run of the brief above. Here the first song read short of its high-band floor, was composed again and passed.

The best attempt is kept. If a song still fails, the report says so and the command exits with an error; it does not pass a song quietly.

Limits.

  • The gate stage and redo first shipped in DAWN 0.52.0; earlier releases make the album without them.
  • Sung words come from a built-in bank by default. --model local drafts them with a language model you run on your own machine.
  • Singing needs the voice installed once with dawn vocals setup. Without it, a brief can ask for a synth lead in place of a voice.
  • Word recall needs a local speech recognizer; without one the gate is skipped and the report gives the reason.
  • --judge adds a listening pass only if you configure a judge. DAWN ships none, and a judge never decides a redo.
  • The gates measure a master. They do not decide whether a song is good. LOCALHOST was co-written with Claude in the SDK, not generated by dawn album.

The CLI reference lists every command and flag. The FAQ covers price, licence and what leaves your Mac. Install DAWN.