Skip to main content

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

note

This function is meant to be used in Node.js applications. It cannot run in the browser.

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​

ts
import { resolve } from "node:path";
import { extractAudio, getVideoMetadata } from "@remotion/renderer";
 
const videoSource = resolve(process.cwd(), "./path-to-video.mp4");
 
const videoMetadata = await getVideoMetadata(videoSource);
const audioOutput = resolve(
  process.cwd(),
  `./output-audio-path.${videoMetadata.audioFileExtension}`,
);
 
await extractAudio({
  videoSource,
  audioOutput,
});
ts
import { resolve } from "node:path";
import { extractAudio, getVideoMetadata } from "@remotion/renderer";
 
const videoSource = resolve(process.cwd(), "./path-to-video.mp4");
 
const videoMetadata = await getVideoMetadata(videoSource);
const audioOutput = resolve(
  process.cwd(),
  `./output-audio-path.${videoMetadata.audioFileExtension}`,
);
 
await extractAudio({
  videoSource,
  audioOutput,
});

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​

optional

One of verbose, info, warn, error.

Return Value​

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

See also​