---
name: Extract Audio
description: Pull the audio out of a video into its own file, at the best quality for the chosen format.
category: Audio
version: 1
mode: script
language: typescript
inline: ask
args:
  - file_path
inputs:
  file_path:
    type: string
    description: A video file, or a folder to process recursively.
  target_format:
    type: string
    default: mp3
    options: [mp3, m4a, flac, wav, ogg, opus]
    description: Audio format to write.
trigger:
  - type: file
    extensions: [mp4, mkv, webm, mov, avi, wmv, flv, m4v, mpg, mpeg, m2ts, mts, 3gp, ogv, vob, divx, asf, f4v]
  - type: directory
---

# Extract Audio

Writes the audio beside the video — `episode.mkv` produces `episode.mp3` in the same folder.

**The video is never modified and never deleted**, which is why this task has no delete-source option
where Convert Audio has one: extracting is additive, and there is nothing here you would want gone.

Quality matches Convert Audio: 320k for mp3, 256k for m4a, 192k for opus, q6 for ogg, lossless for
flac and wav.

An existing output is skipped rather than overwritten, so a re-run will not quietly replace a file
you have since edited. A video with no audio track at all is reported and skipped.