ffmpeg Node icon

ffmpeg Node

n8n Node for some Ffmpeg functionality

Actions11

Overview

This node provides audio transcoding functionality using ffmpeg. It allows users to convert audio files from one format or codec to another, adjusting parameters such as codec type, bitrate, and number of audio channels. This is useful in scenarios where audio files need to be standardized for compatibility, optimized for size or quality, or prepared for specific playback environments.

Practical examples include:

  • Converting an MP3 file to AAC with a specific bitrate for mobile streaming.
  • Downmixing stereo audio to mono to reduce file size.
  • Changing the audio codec of a podcast episode before publishing.

Properties

Name Meaning
Audio Input A valid audio URL or the name of the input binary field containing the audio to transcode.
Audio Output Name The name of the output binary field where the transcoded audio file will be stored.
Audio Codec The target audio codec to use for transcoding (e.g., mp3, aac, wav).
Transcoding Options Collection of optional settings:
- Audio Bitrate: Target bitrate in kbps (default 128).
- Audio Channels: Number of audio channels (default 1).

Output

The node outputs the transcoded audio file in a binary data field named according to the "Audio Output Name" property. The json output contains metadata about the operation but primarily the binary field holds the actual transcoded audio content ready for further processing or saving.

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg service.
  • Relies on an external ffmpeg-based API or service configured within n8n credentials.
  • No other external dependencies are indicated in the static code.

Troubleshooting

  • Invalid Audio Input: If the input audio URL or binary field name is incorrect or inaccessible, the node will fail to retrieve the source audio. Verify the input path or binary field exists and is correctly referenced.
  • Unsupported Codec: Specifying an unsupported or misspelled audio codec may cause errors. Ensure the codec value matches supported codecs by the underlying ffmpeg service.
  • Bitrate or Channel Errors: Providing invalid values (e.g., negative numbers) for bitrate or channels can lead to failure. Use sensible positive integers.
  • Credential Issues: Missing or invalid API authentication tokens will prevent the node from connecting to the transcoding service. Confirm that the required API key credential is properly set up in n8n.

Links and References

Discussion