Song workflows and media
For agents
Give your agent this page’s Markdown link, or choose a collection.
- Documentation indexFind a guide and its Markdown link.
- Full documentationRead all curated guides in one text file.
- Machine manifestFind page metadata, Markdown URLs and checksums.
DAWN can draft a project, prepare local audio and keep a longer song job resumable. Start from an existing project and inspect each command’s help before adding an optional runtime.
Draft a song
Section titled “Draft a song”dawn make --seed <n> makes a repeatable draft. dawn make --from <chart.json> performs an authored chart. dawn song --list lists the seeded composer’s styles; dawn song writes a project from one of them. A natural-language local-model draft needs a configured local model.
dawn make --helpdawn song --listUse the resulting TypeScript as editable source, then run dawn check and render a review file. Keep an existing song’s source committed or copied before making a new project in its place.
dawn song --palette <palette.json> plays the composed parts with a palette’s sounds; a <collection>/<entry> installed with dawn collection install works too. The notes stay the composer’s. Build a sound palette explains which sound plays each part and how levels are matched.
Run and resume a job
Section titled “Run and resume a job”The workflow registry lists durable procedures, including original songs and reference studies:
dawn workflow listdawn workflow read original-housedawn make --from <chart.json> creates and runs an original-house job; there is no dawn workflow start, which only queued a job that nothing ran. status inspects a record, and cancel and resume mark it cancelled or runnable again. dawn album plans, makes and gates an album with per-stage caching and retained hand edits, and makes a song that fails its gates again. Its help describes the brief and output directory:
dawn album --helpLocal-model stages need an inference runtime and model weights. Set those up separately and account for their disk, memory and compute needs.
For local-model words, --words-best <1-5> compares several candidates; the default is one. --words-sample <n> sets the initial sampling seed. With sung vocals, candidates are sung, rendered and transcribed before selection, so additional candidates need more compute and the singing and transcription runtimes.
Add vocals
Section titled “Add vocals”Stock singing uses the optional local Kokoro and WORLD runtime, and DAWN checks a sung line by listening to it with a local speech recognizer. One command looks for both, and one installs them:
dawn setup # what is here, what is missing and how large it isdawn setup --install # fetch the missing pieces, about 1.9 GB from nothingdawn setup --test # sing a phrase and hear it backdawn vocals doctordawn vocals sing --helpdawn setup --install needs nothing installed first: it fetches its own pinned copy of uv when the machine has none, builds the voice’s Python environment and DAWN’s own speech recognizer, and fetches the Kokoro and whisper models. The voice builds a package or more from source, so it needs a C++ compiler (xcode-select --install on a Mac, build-essential on Debian and Ubuntu); setup says so before it starts. An install ends by singing a short phrase and listening to it, and dawn setup --test does that at any time: it exits 1 when the words do not come back. dawn vocals setup prints the same steps as commands to run yourself and installs nothing. dawn album setup is the same command as dawn setup under its first name; use it when your DAWN has no dawn setup yet. Keep generated takes and their records in the song project so they remain available for a later render. Rendering prepared takes does not require regenerating them.
Study a reference
Section titled “Study a reference”dawn reference prepare accepts a local audio file or a supported video URL and retains source, stems and timing evidence for a study. dawn reference recreate uses the prepared manifest; dawn reference setup describes optional dependencies.
Use recordings you are authorized to process. A URL-based study downloads media and needs network access and the configured helpers. Resulting manifests and derived files stay in the project.
Prepare audio
Section titled “Prepare audio”dawn media doctordawn media --helpdawn media chop --helpMedia commands cover download, stem separation, analysis, audio-to-note extraction, sampling, transcription and chopping. Helpers can use a configured local StemDeck service or tools such as FFmpeg, yt-dlp, Demucs, Basic Pitch and whisper-cli. doctor reports what is available before a longer job.
Chop operations write derived WAVs with sidecar records and retain inputs. Inspect the output and keep the sidecar with the audio. The CLI reference covers checks, exports and measurements after preparation.
Documentation drafted with AI and checked against the product source.