ComfyUI Node

Save Audio Absolute Path

\Music\Masters without playing filename roulette

By jplenio·Created about 16 hours ago·Updated about 15 hours ago· 0
Save Audio Absolute Path
  • audio
  • saved_paths
absolute_directoryD:\Music\MiniMax\Preview
filenametrack
formatmp3
collision_modeauto_increment
create_directoriestrue
mp3_qualityV0 (~245 kbps)
flac_bit_depth24-bit
wav_bit_depth32-bit float
peak_handlingleave_unchanged

ComfyUI's output folder is great until it isn't. For a serious release you want your masters somewhere deliberate - your own D:\Music\Masters or /mnt/audio/releases - not buried in the output directory with forty other preview renders. Save Audio Absolute Path is the no-fuss saver for exactly that: FLAC, MP3 or WAV written to an explicit absolute directory, with quality and bit-depth control, collision handling, and safe peak handling. It's the "get this file somewhere real" node.

Its sibling, Save Audio Smart Prefix, is the one with the folder structure and metadata fanfare; this one is the direct, absolute-path version - one folder, one filename, done. They complement each other, and the pack ships both because sometimes you want the production tree and sometimes you just want the file on your Desktop.

Inputs that matter

  • absolute_directory - the destination, absolute. The default is the author's Windows-style D:\Music\MiniMax\Preview, so change it - on Linux that looks like /home/you/Music/releases.
  • filename - base name without extension; collision handling may add a numeric suffix.
  • format - mp3 (default), flac, or wav. The tooltip sets expectations honestly: FLAC lossless, WAV uncompressed PCM/float, MP3 lossy and "intended mainly for convenient previews/distribution."
  • collision_mode - auto_increment (default), overwrite, or error_if_exists. Overwrite is there if you're iterating on one file; error_if_exists is the guardrail when you never want to silently clobber a master.
  • create_directories (default true) - auto-creates missing folders.
  • mp3_quality - V0 (~245 kbps, default), V2, or fixed 320/256/192 kbps. Ignored for FLAC/WAV.
  • flac_bit_depth - 24-bit (default, recommended for a release archive) or 16-bit.
  • wav_bit_depth - 32-bit float (default; preserves headroom without integer clipping), 24-bit, or 16-bit.
  • peak_handling - leave_unchanged (default) or normalize_only_if_clipping. The second applies one constant gain only when peaks exceed full scale. Note what it isn't: not loudness normalization, not a limiter.

Output

saved_paths - a STRING telling you where the file went (or the base name, depending on what the node reports). It's an output node, so it also finalizes the branch.

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. MP3 encoding leans on imageio-ffmpeg's bundled FFmpeg. Restart ComfyUI and hard-refresh once.

Gotchas

The Windows-style default path is the first trap - anyone on Linux/macOS who queues without editing it will hit a write error or an unexpected directory. Second, "MP3 quality" and "bit depth" settings silently do nothing when the format doesn't use them, so a FLAC save ignores mp3_quality; that's by design, just don't assume otherwise. And respect error_if_exists when it matters: a release master you overwrite is gone for good, and auto_increment is the mode that protects you from yourself.

CategoryMiniMax Music Production Toolkit/save

Inputs (10)

NameTypeDefaultDescription
audioAUDIOComfyUI AUDIO signal to process. The node preserves channel layout unless its processing explicitly states otherwise; check the node's Info/JSON output for sample-rate or level changes.
absolute_directorySTRINGD:\Music\MiniMax\PreviewAbsolute filesystem directory for the audio output, for example D:\Music\Masters. Unlike the smart-prefix saver this destination is not relative to ComfyUI's output folder.
filenameSTRINGtrackBase filename without extension for Save Audio Absolute Path. Collision handling may add a numeric suffix depending on collision_mode.
formatCOMBOmp3Audio file format to write. FLAC is lossless, WAV is uncompressed PCM/float, and MP3 is lossy and intended mainly for convenient previews/distribution where appropriate.
collision_modeCOMBOauto_incrementWhat to do when the target file already exists: auto_increment creates a new numbered filename, overwrite replaces it, and error_if_exists stops with an error.
create_directoriesBOOLEANtrueCreate missing output folders automatically. Disable only if you deliberately want saving to fail when the destination directory does not already exist.
mp3_qualityCOMBOV0 (~245 kbps)MP3 encoder quality/bitrate. V0 is high-quality variable bitrate; fixed 320 kbps is the highest listed constant bitrate. This setting has no effect when saving FLAC or WAV.
flac_bit_depthCOMBO24-bitPCM bit depth used inside the lossless FLAC file. 24-bit is recommended for a release/master archive; 16-bit is smaller and appropriate when explicitly required.
wav_bit_depthCOMBO32-bit floatSample representation used for WAV. 32-bit float preserves headroom without integer clipping; 24-bit is a common release/master format; 16-bit is lower precision.
peak_handlingCOMBOleave_unchangedOptional final safety handling in the saver. leave_unchanged writes the signal as received; normalize_only_if_clipping applies one constant gain only when sample peaks exceed full scale. It does not perform loudness normalization.

Outputs (1)

NameTypeDescription
saved_pathsSTRING