MiniMax Prompt Batch Loader
Batch-loading whole folders of song prompts without the LLM
- caption
- lyrics
- title
- source_name
- seed
- run_index
- source_path
Not every MiniMax workflow goes through an LLM. Maybe you hand-write your captions and lyrics, or you keep a folder of prompt files you've refined over months, and you want to render them all in one queue without retyping a thing. MiniMax Prompt Batch Loader is the no-LLM on-ramp: point it at a directory (or flip to manual mode), and it reads each prompt file and emits song variants with reproducible source metadata and seeds.
Modes
- folder (default) - reads every file in
prompt_directorymatching theextensionslist (default.txt,.prompt,.md), withrecursivetoggling subfolder scanning. Each file is one song source. - manual - uses the fields on the node instead.
manual_title,manual_caption,manual_lyrics. The caption is where musical/production instructions go; the lyrics field is for supported section tags and lyric text. Instrumental tracks should use structural tags, not prose.
Either way, song_count (1–100) controls how many variants each source emits, and seed_mode picks between random_each_song and the reproducible increment_from_base (from base_seed). For batch rendering you can reproduce later, increment mode is the sane default; random mode is for exploration.
Outputs
All lists, mapped across your batch by ComfyUI: caption, lyrics, title, source_name, seed, run_index, and source_path. No image prompt here - this is the audio-only loader. source_path is the prompt file that produced each song, which is exactly the provenance breadcrumb the metadata sidecar wants.
Where it fits
It's the plainest entry point in the pack: LLM-free batch generation straight from files. If your workflow later graduates to an LLM, the sibling nodes (template + parser) slot in upstream and this loader becomes unnecessary - but for reproducible file-driven batches, it's the one you reach for.
Installing it
Pack install via ComfyUI Manager (search "MiniMax Music Production Toolkit") or:
cd ComfyUI/custom_nodes
git clone https://github.com/jplenio/ComfyUI-MiniMax-Music-Production-Toolkit.git
cd ComfyUI-MiniMax-Music-Production-Toolkit
python -m pip install -r requirements.txt
Dependencies: scipy, soundfile, imageio-ffmpeg, mutagen, Pillow. Restart ComfyUI and hard-refresh once.
Gotchas
The directory must live on the machine running ComfyUI, and files with unsupported extensions are silently ignored - if a batch seems short, check your extensions string and that recursive matches where the files actually are. And a caution from the pack's design: garbage prompt files produce garbage songs. The LLM branch exists to enforce the artifact-avoidance rules; this node trusts your files blindly, so the quality bar is on you.
Inputs (10)
| Name | Type | Default | Description |
|---|---|---|---|
| mode | COMBO | folder | Choose folder to read multiple prompt files or manual to use the fields in this node. Folder mode ignores the manual caption/lyrics/title except as implementation fallbacks. |
| prompt_directory | STRING | Directory containing prompt files for folder mode. Files are read according to the configured extensions and recursive setting. | |
| song_count | INT | 11–100 | Number of song variants to emit from the selected source. Higher values repeat the downstream workflow for additional variants and therefore increase total generation time. |
| seed_mode | COMBO | random_each_song | Controls how generation seeds are created for multiple songs. random_each_song chooses a fresh seed per item; increment_from_base produces reproducible sequential seeds starting from base_seed. |
| base_seed | INT | 10–9223372036854776000 | Base integer used when deterministic/incrementing seed generation is selected. With random_each_song it is not the source of the random values; with increment_from_base each variant is derived from this value. |
| extensions | STRING | .txt,.prompt,.md | Comma-separated filename extensions accepted in folder mode, for example .txt,.prompt,.md. Other files are ignored. |
| recursive | BOOLEAN | false | When enabled, prompt files are also discovered in subfolders below prompt_directory. Disable it to process only files directly inside the selected folder. |
| manual_title | STRING | manual-song | Fallback/manual song title used in manual source mode. It may later be replaced by an LLM-generated title depending on the workflow branch. |
| manual_caption | STRING | Manual MiniMax Music caption used when manual source mode is selected. Put musical/production instructions here, not structural Lyrics tags. | |
| manual_lyrics | STRING | Manual MiniMax Music Lyrics field. Use supported section tags and lyric text only; instrumental tracks should contain structural tags rather than prose production instructions. |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| caption | STRING | — |
| lyrics | STRING | — |
| title | STRING | — |
| source_name | STRING | — |
| seed | INT | — |
| run_index | INT | — |
| source_path | STRING | — |