1 · YuE2 · Song
A new song from a short brief: a local text model writes title, style and lyrics, YuE2 plans a score (ABC notation) and renders the song, Master finishes it, and Export writes a 24-bit FLAC with a release record.
▶ Video: Tutorial 1 · YuE2 · Song - the whole path in ComfyUI, narrated, with chapters. All of them in the tutorial playlist.
Song Brief -> Write Song -> Song Sheet · Text -> YuE2 Plan -> Score Tools -> Arrange -> Song Sheet · Score -> YuE2 Render -> Master -> Export Release
^ YuE2 Model (loader, optional instrumental adapter, Engine Profile) feeds all YuE2 stepsQuick start
- Open 1 · YuE2 · Song from the template browser.
- In Song Brief, choose the mode (below), then pick a template or describe the song: the template's values appear in the fields, and each field is a list with ✎ type your own … (Brief templates). length (1:00 to 6:00) and vocals (sung, sparse vocals or instrumental - below) are set only here. lyrics: the writer writes them from the idea in the field below (the template's, or yours), or my own, sung as written below - your lyrics, sung as written; the title then comes from your words.
- Press Run. The first run downloads missing models (YuE2 3B int8) and, unless you have one, the writer's Gemma 4 12B, then takes a few minutes. A YuE2 finetune? Choose it under checkpoint.
- The mastered song appears in the preview and in
output/plenio/as<date> <title>.flac, with the unmastered take<date> <title> (original).flacand the record<date> <title>.plenio.json.
Measured on an RTX 5060 Ti 16 GB: about 3 minutes for a 3-minute song, including writing and planning.
A series or one song: the mode
| Mode | A run | Next run |
|---|---|---|
| new song every run (template default) | writes, plans and renders a song straight through - the sheets do not stop | a different song from the same brief: the writer is asked for a new title, story, images and hook (a new series variation, shown in the brief's summary) |
| one song, stop to review | stops at Song Sheet · Text; after Approve and another run, at Song Sheet · Score; after that Approve the song is rendered | a new take of the approved song: the take seed changes, the text and the score stay (they are cached) |
Many songs with one click: in the mode new song every run, set the batch count next to Run (App mode: Number of runs) to 10 and press Run once - ComfyUI queues ten runs, and each one is a new song, exported under its own title (a repeated title gets (2)). The brief, the length and the vocals stay the same for the whole series.
The song form follows the lyrics: YuE2 plans the melody from the lyrics, but its plan does not always have the lyrics' sections (a bridge left out, a sung intro without words). Match Song Form inside YuE2 Plan puts the plan's own sections in the lyrics' order (chorus words on the chorus melody) or names them after the lyrics; only when that cannot work, YuE2 plans once more with the next seed and the better plan wins. A plan that sings two blocks in one section (the chorus and the outro) stays as it is, and an intro whose only note is the verse's first word is no sung intro. Song Sheet · Score says what was done.
One song, carefully: in the mode one song, stop to review, nothing is rendered before you approved the text and the score. Afterwards, new takes: to get new text, change the Draft seed; for a new score, change the plan seed in YuE2 Plan (both mean reviewing again).
Draft seed: the writer's seed is its own node in 2 · WRITE (and in App mode), like the take seed. 🔒 same seed (default, blue) keeps the draft - and your approval - from run to run; 🎲 new seed (amber) lets the writer draw a new draft every run. Use 🎲 in new song every run for even more varied series; keep it 🔒 in one song, stop to review, otherwise every run brings a new text to approve. The number shown is always the last run's (Seeds).
Inspect and edit what YuE2 receives
Each Song Sheet shows the documents that go to YuE2, exactly as they will be used. Press the sheet's edit button - Edit lyrics & text on Song Sheet · Text (teal), Edit the score on Song Sheet · Score (violet):
| You do | The document becomes | What happens later |
|---|---|---|
| nothing | auto | the newest draft is used |
| change the text | edited | your text is used while the draft stays the same; if the draft changes (new draft seed, new plan), the run stops with a conflict and asks you |
| press Make manual | manual | your text is always used; the draft is not even computed |
| press Use draft (Back to auto when no draft is known, as for a manual document) | auto | back to the draft; the next run computes it again |
In a conflict you choose: keep your edit (manual), use the new draft, or merge by hand.
Review: the sheets' review is set to as the brief says: they stop in the mode one song, stop to review and continue in new song every run. Set a single sheet to stop for review or continue to override the brief (for example: review only the text, never the score). A stopped run waits after that sheet until you press Approve in the editor; approving is valid only for exactly the documents you saw.
Edits in a series: in the mode new song every run each run brings a new draft, so an edited document conflicts on the next run. Make it manual instead - the whole series then uses your text (for example a fixed style line while the lyrics change).
Two sheets are needed because the score is planned from the final text: Song Sheet · Text owns title, style, lyrics and artwork prompt; Song Sheet · Score owns the score and shows the text as context.
Creative modes: a planned arrangement
Experimental. Creative modes and the closeness sliders can give unexpected results - a chord that surprises, an instrument line that does not fit every song, a plan that is not applied. They are meant for experimenting first: try a mode, listen, change the score in the Song Sheet or run again with another arrangement seed, and keep what you like. off is the dependable choice. ▶ Tutorial 6 · YuE2 · Song · Creative modes shows it.
The brief's arrangement is off by default: YuE2 plans melody, chords and instruments by itself, and Arrange passes its score through untouched (nothing runs there). Choose a creative mode - standard, varied, fantasy, sterile, many instruments, dramatic or your own - and set the genre closeness (100 strictly typical, 70 typical with personal touches, 40 free within the genre, 0 any style):
- The writer's prompt gets the mode's hints (for example many instruments: a large ensemble in the style).
- After YuE2's plan, Arrange asks the writer model for a section plan - chords per bar, what the instrument line plays, energy, the tempo (a key lift only in the mode key change) - and Plenio writes those notes into the score and checks it.
- Song Sheet · Score shows the arranged score; its summary and the editor's Arrangement line say what was arranged and what stayed. A plan Plenio cannot use leaves YuE2's score as it was, and the sheet warns.
Plan seed (in 4 · SCORE, under the plan, and in App mode): 🎲 lets YuE2 plan another melody and form for the same lyrics, 🔒 (default) keeps the plan.
Arrangement seed (in 4 · SCORE and in App mode): another arrangement of the same song - only Arrange and what follows run again. The plan is written by the template's Writer model (the same as for the text); details, the modes and what each slider allows: Creative modes.
Sparse vocals
Set vocals to sparse vocals for a song that is mostly instrumental and where the voice sings only now and then - a hook phrase, a call, a short chant or wordless sounds (ooh, hey) that fit the song and carry its melody. Language, voice and theme are set as for a sung song. The writer gets a section form of its own: as many sections as a sung song of the length, most of them empty ([Instrumental], a [Break] before the last hook) and two to four [Hook] sections - about one a minute - with one or two short lines each, at most two lines per hook in the whole song (6 for 3:00, where a sung song has about 22). YuE2 plays the empty sections as instrumental parts. With a score of your own (the DAW template) the score's sections stay, and the writer puts the words into one to three of them.
The draft and the Song Sheet warn when the lyrics have more than twice as many lines (Sparse vocals: the lyrics have …); delete lines or leave more sections empty. How YuE2 plans and sings such sparse lyrics has not been measured yet: plan again with another seed when a plan comes out much shorter than the brief's length.
Instrumental songs
Set vocals to instrumental and choose instrument plays the lead or accompaniment only. Plenio then guarantees an instrumental conditioning: the lyrics are the single tag [instrumental] (YuE2 plans the form itself - bare tags gave the most instrument-like takes in a listening test), a style without vocal or language words, and a score whose Vocal voice is silent (the melody moves to the instrument, or is removed).
For instrumental songs the planner reads a section form that fits the length (Intro, Verse, Chorus ... Outro; never sung - the render gets [instrumental]), so the song has parts instead of one repeating loop. YuE2 still chooses the length of instrumental plans itself (63-387 s for an 80-s request in Phase 4A; up to 14 minutes for 3:00 in electronic songs). Score Tools then splits a part of more than 16 bars - YuE2 often plans an intro and one long part - into parts of 8 or 16 bars at phrase ends, named by their music (a part that comes back takes the first one's name; only the section starts change, never a note), so the arrangement and the render have sections to vary. When a plan is more than 1.2 times or less than 0.8 times the brief's length, Score Tools fits it (fit length): too long, it removes whole sections or - inside a long section - the bars between the start and the plan's own ending, at a phrase; too short, it repeats the middle of the song. The beginning and the ending stay, so the song ends as the planner wrote it. The score sheet says what changed; edit the score or plan again with another seed if you want a different cut.
The audio itself is not guaranteed free of voice-like sounds. To measure it, add Audio Encoder Loader (SheetSage2) and Check Vocals after the render - see Instrumental.
What the checks mean
- Style: one comma-separated line of about 40 words; no song structure, timing or negations. The 40 words are a target, not a limit: above 60 words the sheet warns, above 120 it is an error.
- Lyrics:
[Tag]lines with sung lines beneath; no stage directions or repeat marks. - Score length: YuE2 plans roughly 8-10 seconds per sung line. If the plan is much longer or shorter than the brief's length, the score sheet warns.
- Budget: style, lyrics and score share YuE2's context of 24 576 tokens with the music (25 tokens per second). The score sheet shows how many seconds of music fit.
Finishing: Master, cover art, files
- Plenio · Master (group FINISH) masters every take before Export: a gentle warm tone match and -14 LUFS with a true peak of at most -1 dBTP. First come the stems when you switch stems on on the block (off by default; the mixer is inside the block), then, before the EQ, Audio HQ: HQ 1 · Stereo Cleanup is on, HQ 2 · Regenerate Highs (UniverSR, 229 MB; about 1.5 s per second of music on an RTX 5060 Ti) runs with the HQ Mastering switch at the top of the template (off by default): on, HQ 2 · Regenerate Highs runs - it can clearly reduce AI shimmer and artifacts, but the song takes about twice as long, HQ 3 · De-Reverb is bypassed; their presets follow the brief's genre (auto). Open the block to change an HQ preset, bypass a stage, or change the EQ, the loudness target or the compression style; its sample rate is on the block. Details: Mastering and audio formats.
- Export Release writes the mastered song, the unmastered take as
(original).flac, the release record and the sheet music as<name>.pdf- the final score with the lyrics under the notes, on A4 (sheet music on the node: A4, Letter or off; sheet music size: standard about 3 bars a line, smaller, compact or large; an open ComfyUI page draws it right after the export, whichever workflow it shows). It also writes the lyrics as subtitles -<name> (lines).srtand<name> (notes).srt, timed by listening - and fills the tags from the brief ({genre},{lyrics}...; the Tags & variables note lists every variable). Formats (FLAC, MP3, WAV) and tags are set on the node; see Tags, variables and lyrics subtitles. - Cover Art (on) paints a cover from the sheet's artwork prompt with FLUX.2 Klein 4B (4 steps, 1024 x 1024; about 16 GB of model files, Apache-2.0). The Cover Art card in HQ Mastering & Cover Art at the top switches it off (its three nodes are then bypassed, no image model loads). Export embeds the cover in the FLAC and MP3 files and saves it next to the song as
.jpg. In new song every run the cover seed is 🎲 (every song its own cover); with one song, stop to review it is 🔒, so new takes of the song keep the cover.
App mode
Switch Graph / App at the top left for a simple form with the mode, the brief (with arrangement and genre closeness), the writer model, the take, draft and arrangement seeds and the buttons Song Sheet · Text and Song Sheet · Score - review and editing work in the app as in the graph; see App mode.
Licence
YuE2 weights are CC BY-NC 4.0 (non-commercial). The release record names the licence of the models used.