Nodes/VRGameDevGirl Video Enhancement Nodes/VRGDG_MusicVideoPromptCreator
ComfyUI Node

VRGDG_MusicVideoPromptCreator

Turn lyrics and a style brief into a cinematic scene prompt

By vrgamegirl19·Created about a year ago·Updated about 7 hours ago· 718
VRGDG_MusicVideoPromptCreator
  • signal
  • concatenated_string
character_descriptionThe Women.
song_theme_styleCinematic, dramatic, vibrant, and edgy
pipe_separated_lyricsline1 | line2 | line3
word_count_min30
word_count_max50
environment rain-slicked city street, night, minimalist, industrial warehouse.
lightingHigh-contrast, dramatically moody, hard shadows, single, intense practical light sources, cool blues, sharp whites.
camera_motiondolly movements, track alongside, swift, sudden whip pans, emphasize dramatic shifts, dynamic motion.
physical_interactionwalks through environments while touching walls or objects. Touches hair, gesture toward the camera to connect.
facial_expressionIntense raw emotion and Brief moments of calm break the tension.
shotsUse a mix of close-ups and medium shots for intimacy and Wide moving shots follow the performer through spaces.
outfit_rulesa white dress
character_visibilityFully present for a majority of shots

VRGDG_MusicVideoPromptCreator is the node the README tells you to customize: "Customize the Prompt Creator to define style, mood, and scenes." It takes a pile of text fields - character, lyrics, environment, lighting, camera work - and assembles them into one long, coherent scene prompt. No LLM involved, no randomness: it's a carefully built string templater, and for the LTX-2.3 music-video workflow it's the place where your creative choices actually live.

It exists because LTX-class video models reward long, detailed prompts, and because the workflow needs every scene to stay consistent. The defaults are a dead giveaway - character_description is literally "The Women." and outfit_rules is "a white dress." Change those two and you've changed the protagonist of the entire video. That's the design: set your character, style, environment, lighting, camera motion, expressions, and shot list once, feed the scene's pipe_separated_lyrics (lines separated by |), and get back a full paragraph ready for the model.

The inputs that matter

You can't realistically tune all 13 fields on every scene, so here's the short list:

  • pipe_separated_lyrics - the actual lines for this scene. This is the one input that changes per scene; the rest are your video's identity.
  • character_description and outfit_rules - who's on screen and what they wear. Keep these identical across every scene or your character will drift.
  • word_count_min / word_count_max - target length of the assembled prompt, 10–200. Start at the 30/50 defaults; LTX likes detail but a 200-word prompt is a different beast.
  • environment, lighting, camera_motion, physical_interaction, facial_expression, shots, character_visibility - the cinematic vocabulary. More specific here means fewer "the model ignored my prompt" reruns.
  • signal - a wildcard trigger so the rest of the graph controls when this fires.

The single output is concatenated_string, which you wire into your prompt encoder. That's the whole node's job, and the output is deterministic - same inputs, same paragraph, every time.

How it fits the workflow

In the full pipeline, this node replaces (or complements) the LLM prompt writer: the LLM_PromptBatcher handles the story-level scene prompts, while this one is the hand-tuned, fully-controlled option for a specific scene. If you want one scene to be perfect - the chorus, the money shot - you write its lyrics in here and keep the style fields locked. It's also great standalone for hand-building LTX prompts without the whole workflow.

Setup

Same shared pack:

cd ComfyUI/custom_nodes
git clone https://github.com/vrgamegirl19/comfyui-vrgamedevgirl

or Manager → search "vrgamedev", restart.

The one thing that bites people: the defaults are the author's demo content ("The Women.", "a white dress"), so if you run it as-is you'll get prompts about a woman in a white dress on a rain-slicked street. That's not a bug - it's a starting point you're supposed to overwrite. Miss that and every scene you generate will be inexplicably about that one outfit. Change the character fields first, then the world-building, and the node quietly becomes the best thing in the pack.

CategoryVRGDG/Prompt Tools

Inputs (14)

NameTypeDefaultDescription
character_descriptionSTRINGThe Women.
song_theme_styleSTRINGCinematic, dramatic, vibrant, and edgy
pipe_separated_lyricsSTRINGline1 | line2 | line3
word_count_minINT3010–200
word_count_maxINT5010–200
environmentSTRING rain-slicked city street, night, minimalist, industrial warehouse.
lightingSTRINGHigh-contrast, dramatically moody, hard shadows, single, intense practical light sources, cool blues, sharp whites.
camera_motionSTRINGdolly movements, track alongside, swift, sudden whip pans, emphasize dramatic shifts, dynamic motion.
physical_interactionSTRINGwalks through environments while touching walls or objects. Touches hair, gesture toward the camera to connect.
facial_expressionSTRINGIntense raw emotion and Brief moments of calm break the tension.
shotsSTRINGUse a mix of close-ups and medium shots for intimacy and Wide moving shots follow the performer through spaces.
outfit_rulesSTRINGa white dress
character_visibilitySTRINGFully present for a majority of shots
signal*

Outputs (1)

NameTypeDescription
concatenated_stringSTRING