Nodes/comfyui_lyric_align/Lyrics Load File
ComfyUI Node

Lyrics Load File

The boring loader node that actually carries the whole lyrics workflow

By bmad4ever·Created 2 days ago·Updated about 18 hours ago· 0
Lyrics Load File
    • lyrics
    pathlyrics.txt

    Every other node in this pack wants the same thing: your ground-truth lyric sheet as a text string. You could paste it into each one, but that's the kind of thing you do once and regret - edit the lyrics, and now every node in the graph is holding a stale copy. LyricsLoadFile reads a .txt sheet from disk and hands the text to everything downstream from one place. It's the least interesting node in the pack and the one the whole thing depends on.

    Input and output

    • path (STRING, default lyrics.txt): path to the lyric sheet. Relative paths resolve against ComfyUI/input/, so lyrics.txt means ComfyUI/input/lyrics.txt. Absolute paths work too.
    • lyrics (STRING): the file's contents, one line per lyric line, blank lines preserved as section breaks.

    That formatting convention matters more than it looks. The pack's alignment treats a blank line as a structural break between sections, so keep your sheet laid out like the song's verses and choruses rather than one giant paragraph. Garbage in, garbage alignment out.

    The mechanism detail worth knowing

    The node watches the file's modification time - its IS_CHANGED returns the file's mtime, which tells ComfyUI the output changed when the file does. Edit one word in lyrics.txt, hit run, and the alignment downstream updates without you touching a widget or re-selecting anything. That auto-rerun is the whole reason to route every node through this loader instead of pasting the sheet in five places: one source of truth, and edits propagate for free.

    Install

    Same pack as everything else - ComfyUI Manager search "comfyui_lyric_align", or:

    cd ComfyUI/custom_nodes
    git clone https://github.com/bmad4ever/comfyui_lyric_align
    

    Then restart ComfyUI. This node needs nothing beyond the base install; the heavy dependencies (torchaudio) and the 1.18 GB model download only matter when you run an actual alignment.

    Troubleshooting

    FileNotFoundError with a full resolved path is the only real failure mode, and the message tells you exactly where it looked. You either named a file that isn't in ComfyUI/input/, or you need an absolute path. UTF-8 is the expected encoding; if a file reads back with mojibake, re-save it as UTF-8 without a BOM.

    Categoryaudio/lyrics

    Inputs (1)

    NameTypeDefaultDescription
    pathSTRINGlyrics.txtPath to a .txt lyric sheet. Relative paths resolve against ComfyUI/input/.

    Outputs (1)

    NameTypeDescription
    lyricsSTRING