ComfyUI Node: Audio Pitch Shift

Audio Pitch Shift:

SaltAudioPitchShift is a powerful node designed to modify the pitch of an audio file by shifting it up or down in semitones. This node is particularly useful for AI artists who want to experiment with different audio effects, create unique soundscapes, or adjust the pitch of audio samples to better fit their creative projects. By leveraging the capabilities of the ffmpeg tool, SaltAudioPitchShift ensures high-quality pitch shifting while maintaining the original audio's integrity. This node is essential for anyone looking to manipulate audio pitch effortlessly and effectively.

Audio Pitch Shift Input Parameters:

audio

This parameter accepts the audio data that you want to process. The audio should be in a binary format, typically a .wav file. This is the primary input that the node will modify by shifting its pitch.

semitones

This parameter determines the number of semitones by which the audio pitch will be shifted. It accepts a floating-point number, allowing for precise control over the pitch shift. The value can range from -12.0 to 12.0, where negative values lower the pitch and positive values raise it. The default value is 0.0, which means no pitch shift. Adjusting this parameter will directly impact the audio's pitch, enabling you to create various audio effects.

Audio Pitch Shift Output Parameters:

audio

This output parameter provides the pitch-shifted audio data. The output is in the same binary format as the input, typically a .wav file. This modified audio can then be used in further processing or directly in your creative projects. The pitch-shifted audio retains the original quality while reflecting the changes specified by the semitones parameter.

Audio Pitch Shift Usage Tips:

• To achieve a subtle pitch shift, use small values for the semitones parameter, such as 0.5 or -0.5.
• For dramatic effects, experiment with larger values, but be mindful of the potential for audio distortion at extreme settings.
• Combine this node with other audio processing nodes, such as SaltAudioNormalize or SaltAudioReverb, to create complex and unique soundscapes.

Audio Pitch Shift Common Errors and Solutions:

Error during pitch shifting: <error_message>

• Explanation: This error occurs when the ffmpeg command fails to execute properly, possibly due to incorrect input data or issues with the ffmpeg installation.
• Solution: Ensure that the input audio data is in the correct format and that ffmpeg is properly installed and accessible from your system's PATH. If the problem persists, check the specific error message for more details and consult the ffmpeg documentation for troubleshooting.

File not found: <temp_input_path>

• Explanation: This error indicates that the temporary input file could not be created or accessed.
• Solution: Verify that the temporary directory is writable and that there is sufficient disk space. Ensure that the file paths are correctly specified and that there are no permission issues.

File not found: <temp_output_path>

• Explanation: This error indicates that the temporary output file could not be created or accessed.
• Solution: Similar to the input file error, check the temporary directory's permissions and available disk space. Ensure that the ffmpeg command is correctly generating the output file.