ComfyUI Node: Audio Sink

Audio Sink:

The TT-AudioSink node is designed to facilitate the saving of audio data in WAV format, providing a streamlined method for handling audio output within your workflow. This node is particularly beneficial for AI artists who need to manage and store audio data efficiently. By utilizing this node, you can ensure that your audio files are saved with the desired filename and format, while also having the option to overwrite existing files or prevent overwriting by automatically incrementing filenames. The primary function of the TT-AudioSink node is to take audio data in the form of WAV bytes and save it to a specified directory, making it an essential tool for organizing and preserving audio outputs in your projects.

Audio Sink Input Parameters:

wav_bytes

This parameter represents the audio data in WAV format that you wish to save. It is crucial as it contains the actual audio content that will be written to a file. The node requires this data to perform its primary function of saving audio files.

filename

The filename parameter allows you to specify the name of the audio file to be saved. It is a string value with a default of "AudioSink". This parameter is important for identifying and organizing your saved audio files. Ensure that the filename is not empty, as this will cause an error.

save_format

This parameter specifies the format in which the audio file will be saved. Currently, the only supported format is 'wav'. This ensures that the audio data is stored in a widely compatible and high-quality format.

save_output

The save_output parameter is a boolean that determines whether the audio data should be saved. By default, it is set to True, meaning the audio will be saved unless explicitly set to False. This parameter provides flexibility in deciding whether to persist the audio data to disk.

overwrite_existing

This boolean parameter controls whether existing files with the same name should be overwritten. By default, it is set to True, allowing overwriting. If set to False, the node will automatically increment the filename to avoid overwriting existing files, ensuring that no data is lost unintentionally.

Audio Sink Output Parameters:

The TT-AudioSink node does not produce any output parameters. Its primary function is to save audio data to a file, and it does not return any values upon completion.

Audio Sink Usage Tips:

• Ensure that the filename parameter is not left empty to avoid errors during the saving process.
• Use the overwrite_existing parameter wisely to prevent accidental data loss by overwriting important files.
• If you do not wish to save the audio data, set the save_output parameter to False to skip the saving process.

Audio Sink Common Errors and Solutions:

Filename cannot be empty

• Explanation: This error occurs when the filename parameter is left empty, which is not allowed.
• Solution: Provide a valid string for the filename parameter to ensure the audio file can be saved correctly.

Output directory <directory_path> does not exist

• Explanation: This error indicates that the specified output directory does not exist, preventing the node from saving the audio file.
• Solution: Verify that the output directory path is correct and that the directory exists. Create the directory if it does not exist.

File already exists and overwrite is disabled

• Explanation: This error occurs when a file with the same name already exists, and the overwrite_existing parameter is set to False.
• Solution: Either enable overwriting by setting overwrite_existing to True or allow the node to increment the filename automatically to avoid overwriting.