extractAudio()<AvailableFrom v="4.0.49" />

Extracts the audio from a video source and saves it to the specified output path. It does not convert the audio to a different format.

Example

import {resolve} from 'node:path';
import {extractAudio, getVideoMetadata} from '@remotion/renderer';

const videoSource = resolve(process.cwd(), '/Users/john/path-to-video.mp4');

const videoMetadata = await getVideoMetadata(videoSource);
const audioOutput = resolve(process.cwd(), `./output-audio-path.${videoMetadata.audioFileExtension}`);

await extractAudio({
  videoSource,
  audioOutput,
});

:::info Pass an absolute path to extractAudio(). URLs are not supported. :::

Arguments

An object containing the following properties:

videoSource

string

The path to the video source from which the audio will be extracted.

outputPath

string

The path where the extracted audio will be saved. The file extension must match the audio codec. To find the appropriate file extension, use getVideoMetadata() to read the field audioFileExtension.

logLevel?

binariesDirectory?<AvailableFrom v="4.0.120" />

Return Value

The function returns a Promise<void>, which resolves once the audio extraction is complete.

Compatibility

See also

• Source code for this function
• getVideoMetadata()