msch-lyric-sync
Legacy component. Install MSCH Nodes instead: github.com/mariobilly/msch-comfyui-nodes
Nodes (4)
Make pasted lyrics land on the right words, not just the right song
Turn your music video into a living word grid — and keep the singer visible underneath
Karaoke captions that actually match the song — bilingual, timed, and tasteful
The color knob for your lyric mosaic — pick the palette, keep the vibe
Superseded by MSCH Nodes: one install for the complete collection.
This standalone repository is retained for historical links and existing installations. New nodes and updates belong to the unified pack. Follow the migration guide before switching to avoid duplicate nodes.
MSCH Lyric Sync
Align pasted lyrics to audio and render bilingual captions or animated lyric mosaics with editable color palettes.
Node reference · Example workflows and results · Publishing guide
<!-- MSCH SHOWCASE -->
View the showcase: videos, images and workflows
<!-- /MSCH SHOWCASE -->Included nodes
| Node | What it does | |---|---| | 🎤 Lyric Sync — Align | Combine a ComfyUI AUDIO value with user-supplied lyric lines. | | 🎨 Lyric Sync — Palette | Build a normalized palette from up to twelve color swatches plus additional newline-separated hex colors. | | 🟪 Lyric Sync — Word Mosaic | Rebuild video frames as a scrolling text grid with colored cells and lyric word boxes. | | 🎤 Lyric Sync — Caption Overlay | Draw timed lyric captions in rounded boxes over IMAGE frames. |
Installation
Clone into ComfyUI/custom_nodes:
git clone https://github.com/mariobilly/msch-lyric-sync.git
Open a terminal in the cloned folder and install requirements using the same Python environment as ComfyUI:
python -m pip install -r requirements.txt
Windows portable, from ComfyUI_windows_portable:
.\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\msch-lyric-sync\requirements.txt
Restart ComfyUI and refresh the browser. Load a JSON workflow from examples/ and select the supplied demo input or your own media. Keep only one installed copy of each package to avoid duplicate node registrations.
Requirements and behavior
WhisperX is optional and runs as a separate command-line program. Set whisperx_exe or put whisperx on PATH. If alignment is unavailable or fails, lines receive evenly distributed timing; that fallback is not measured vocal synchronization. Set font_path to an installed Arabic-capable font for Arabic text. Image effects require an explicit matching frame_rate.
Documentation and examples
docs/NODES.md documents every input, default, range, choice and output. examples/README.md explains which inputs and other nodes each workflow needs and how the included results were produced.
ComfyUI Manager
The release includes Comfy Registry metadata and a GitHub publishing action. Version 0.1.0 was uploaded successfully to Comfy Registry under publisher mariobilly on 2026-09-06. Registry reported Pending at verification; Manager installation availability is not yet confirmed. A separate ComfyUI Manager node-list registration has been submitted; listing is pending maintainer acceptance. Git installation works independently. See PUBLISHING.md.
Validation
Imports and input schemas were checked against the local ComfyUI environment with Python 3.12.10, PyTorch 2.10 and CUDA available. Example render coverage is documented per workflow; this is not a claim of compatibility testing on every platform or of full MiniMax H3 model-generation validation.
License
Project code: MIT. Third-party assets and optional model weights keep their own licenses.