josanabr/ffmpeg_extract_audio repository overview

⁠Overview

josanabr/ffmpeg_extract_audio is a lightweight, multi-platform container image for extracting audio from video files and converting it to MP3 with ffmpeg.

The image is designed for a simple command-line workflow: mount a directory containing your video files as /input, mount a Docker volume or host directory for output as /audio, and pass the input video path when running the container.

⁠Features

• Extracts audio from common video formats using ffmpeg
• Encodes the output as MP3
• Accepts runtime arguments directly from docker run
• Prevents accidental overwrites unless --overwrite is explicitly provided
• Multi-architecture image supporting:
  • linux/amd64
  • linux/arm64
• Compatible with both standard PCs and Apple Silicon devices, including MacBook Pro M4

⁠Quick Example

docker container run --rm \
  -v "$(pwd)":/input \
  -v multimedia:/audio \
  josanabr/ffmpeg_extract_audio /input/video.mp4

This command extracts the audio track from /input/video.mp4 and stores the resulting MP3 in /audio.

⁠Runtime Arguments

Because the container uses a Python-based entrypoint, you can pass arguments directly at runtime.

Show help:

docker container run --rm josanabr/ffmpeg_extract_audio --help

Supported arguments:

• <video_file>: path to the input video file inside the container
• --output-dir <path>: output directory for the generated MP3 inside the container
• --overwrite: overwrite the output file if it already exists

⁠Typical Use Cases

• Converting recorded classes, meetings, or screencasts into MP3
• Extracting audio tracks for transcription workflows
• Reusable media-processing tasks in scripts or automation pipelines