Extensions/ComfyUI-SaveMP3CustomPath-WithPlayer
ComfyUI Extension

ComfyUI-SaveMP3CustomPath-WithPlayer

ComfyUI node: Save AUDIO as MP3 to any custom path with selectable bitrate (128k/256k), inline audio player and optional workflow JSON export.

By Slartibart23·Created 5 months ago·Updated a day ago· 1
Slartibart23/ComfyUI-SaveMP3CustomPath-WithPlayer
Nodes1
On cloudLocal install
Categoryaudio/save
Stars1
Updateda day ago

Nodes (1)

💾 Save MP3 (Custom Path)

ComfyUI Only Saves Audio to Its Own Folder — This Node Doesn't

audio/save
Readme

ComfyUI – Save MP3 (Custom Path) with Player

Python License: MIT ComfyUI

Ein ComfyUI Custom Node, der generiertes Audio als MP3 an einem frei wählbaren absoluten Pfad speichert (z. B. D:\omnivoice\person1 oder E:\luca\proj01), einen Audio-Player direkt im Node einblendet und auf Wunsch den kompletten Workflow als JSON mit identischem Dateinamen daneben ablegt. Über einen optionalen Text-Input (z. B. Prompt oder beliebige Text-Node) wird der Text zusätzlich als .txt mit exakt demselben Dateinamen gespeichert.

Inhalt

Features

  • 💾 Frei wählbarer Speicherort — jedes Laufwerk, jede Ordnerstruktur, Ordner wird automatisch angelegt
  • ✏️ Frei wählbarer Dateiname — ohne Endung, .mp3 wird automatisch angehängt
  • 🎚️ Bitrate wählbar — 128k oder 256k
  • 🔢 Automatischer Counter — audio_00001.mp3, audio_00002.mp3, … (oder Überschreiben)
  • 🎧 Audio-Player direkt im Node — anhören ohne Datei extern zu öffnen
  • 📝 Text-Input — optional verbundener Text (z. B. Prompt) wird als <dateiname>.txt mit identischem Dateinamen gespeichert
  • 🧩 Workflow-JSON — speichert den kompletten Workflow als <dateiname>.json im selben Ordner
  • ⚡ Robust — Encoding direkt über ffmpeg-stdin-Pipe, keine Abhängigkeit von torchaudio/torchcodec

Installation

Variante 1: Über ComfyUI Manager

Manager → Install via Git URL → URL des Repos einfügen → Install. ComfyUI neu starten.

Variante 2: Manuell mit GitHub Desktop / git clone

cd ComfyUI/custom_nodes
git clone https://github.com/Slartibart23/ComfyUI-SaveMP3CustomPath-WithPlayer.git

Anschließend ComfyUI neu starten.

Variante 3: ZIP-Download

  1. Repository als ZIP herunterladen (grüner Code-Button → Download ZIP)
  2. ZIP nach ComfyUI/custom_nodes/ entpacken
  3. Ordner heißt am Ende ComfyUI/custom_nodes/ComfyUI-SaveMP3CustomPath-WithPlayer/
  4. ComfyUI neu starten

ffmpeg-Voraussetzung

Der Node nutzt ffmpeg zum MP3-Encoding. Wähle einen der beiden Wege:

A) ffmpeg im System-PATH (empfohlen)

  • Windows: Build von https://www.gyan.dev/ffmpeg/builds/ herunterladen, entpacken, den bin-Ordner zum PATH hinzufügen
  • macOS: brew install ffmpeg
  • Linux: sudo apt install ffmpeg o. ä.
  • Prüfen mit ffmpeg -version

B) Über pip (im ComfyUI-Python-Environment)

pip install imageio-ffmpeg

Bei einer portablen Windows-Installation:

python_embeded\python.exe -m pip install imageio-ffmpeg

Benutzung

Node-Menü:

Add Node  →  audio  →  save  →  💾 Save MP3 (Custom Path)

Oder per Doppelklick auf den Canvas → Save MP3 eintippen.

Den audio-Output deines TTS- / Audio-Generator-Nodes mit dem audio-Input dieses Nodes verbinden, Pfad und Dateinamen eintragen, Workflow ausführen — fertig. Im Node erscheint anschließend der Audio-Player zum direkten Anhören.

Optional: Den text-Input mit einer beliebigen Text-Quelle verbinden (z. B. dem Prompt deiner TTS-Node oder einer Text-Node). Ist der Input verbunden, wird der Text automatisch als .txt mit identischem Dateinamen neben der MP3 abgelegt. Ohne verbundenen Input funktioniert der Node wie gewohnt — es wird dann einfach keine Text-Datei erzeugt.

Parameter

| Parameter | Typ | Beschreibung | | --------------- | --------------- | ------------------------------------------------------------------------------- | | audio | AUDIO | Audio-Input vom vorherigen Node | | text | STRING (optional, nur Input) | Optionaler Text-Input (z. B. Prompt). Wird als <dateiname>.txt gespeichert | | output_path | STRING | Zielordner, z. B. D:\omnivoice\person1 — wird angelegt, falls nicht vorhanden | | filename | STRING | Dateiname ohne Endung, z. B. voice_take → wird zu voice_take.mp3 | | quality | 128k / 256k | MP3 Bitrate | | overwrite | BOOLEAN | True = vorhandene Datei überschreiben. False = Counter anhängen | | save_workflow | BOOLEAN | True = Workflow zusätzlich als <dateiname>.json im selben Ordner ablegen |

Text-Datei (TXT)

Ist der text-Input verbunden, wird der Text bei jedem Run als UTF-8-kodierte .txt im selben Ordner gespeichert — mit exakt demselben Dateinamen wie die MP3:

  • Bei aktivem Counter bleibt das Namens-Trio erhalten: voice_take_00003.mp3 ↔ voice_take_00003.txt ↔ voice_take_00003.json
  • Es gibt keinen separaten Schalter: verbundener Input = Text wird gespeichert, kein Input = keine Text-Datei
  • So liegt zu jeder Audio-Datei automatisch der zugehörige Prompt/Text dabei

Workflow-JSON

Mit save_workflow = True wird der aktuelle Workflow im UI-Format gespeichert — exakt das, was ComfyUI beim "Save" / "Export"-Button produziert.

  • Datei kann per Drag & Drop in den Canvas gezogen oder über "Load" geladen werden → kompletter Graph wird wiederhergestellt
  • Bei aktivem Counter bleibt das Namens-Paar erhalten: voice_take_00003.mp3 ↔ voice_take_00003.json
  • Speichert also bei jedem Run automatisch das passende Rezept zum Audio dazu

Troubleshooting

ffmpeg wurde nicht gefunden → Siehe Installation, Abschnitt ffmpeg-Voraussetzung. Entweder ffmpeg in den PATH legen, oder pip install imageio-ffmpeg im ComfyUI-Environment ausführen.

Datei wird gespeichert, aber Player erscheint nicht → Browser-Cache leeren (Strg+F5). Das Audio liegt in jedem Fall am Zielort. Falls weiterhin kein Player erscheint: Node aus dem Workflow entfernen und neu hinzufügen.

Text-Input erscheint nicht am Node → Nach dem Update den Node einmal aus dem Workflow entfernen und neu hinzufügen (ComfyUI cached die Node-Definition im Workflow).

Backslashes in Pfaden → Müssen im Node-Feld nicht verdoppelt werden — D:\omnivoice\person1 reicht.

Stereo / Mehrkanal → Bei [Batch, Channels, Time]-Tensor wird das erste Batch-Element genommen, Kanäle bleiben erhalten.

Lizenz

MIT — siehe LICENSE.