ragedunicorn/ffmpeg repository overview

⁠FFmpeg Alpine Docker Image

A lightweight FFmpeg build on Alpine Linux with extensive codec support for versatile media processing.

⁠Quick Start

# Pull latest version
docker pull ragedunicorn/ffmpeg:latest

# Or pull specific version
docker pull ragedunicorn/ffmpeg:7.1.5-alpine3.24.1-1

# Run FFmpeg
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 output.mp4

⁠Features

• 🚀 Small footprint: ~55MB compressed (~190MB on disk) runtime image
• 📦 FFmpeg 7.1.5: Latest stable version compiled from source
• 🎥 Extensive codec support: H.264, H.265/HEVC, VP8/VP9, AV1, MP3, AAC, Opus, and more
• 🏗️ Multi-platform: Supports linux/amd64 and linux/arm64
• 🔧 Optimized build: Multi-stage Docker build for minimal size

⁠Supported Codecs

Video: H.264 (libx264), H.265/HEVC (libx265), VP8/VP9 (libvpx), AV1 (libaom, libsvtav1, libdav1d), Theora
Audio: AAC (libfdk-aac), MP3 (libmp3lame), Opus, Vorbis
Other: WebP support, AVIF output, RTMP streaming, SSL/TLS, Subtitles (libass), Text rendering with drawtext (DejaVu fonts included)

⁠Usage Examples

⁠Convert video format

docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest \
  -i input.mp4 -c:v libx264 -c:a aac output.mp4

⁠Extract audio

docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest \
  -i input.mp4 -vn -acodec mp3 output.mp3

⁠Resize video

docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest \
  -i input.mp4 -vf scale=1280:720 output.mp4

⁠Convert image to AVIF

docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest \
  -i input.png -c:v libaom-av1 -still-picture 1 output.avif

⁠Create GIF from video

docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest \
  -i input.mp4 -vf "fps=10,scale=320:-1" output.gif

⁠Tags

This image uses semantic versioning that includes all component versions:

Format: {ffmpeg_version}-alpine{alpine_version}-{build_number}

⁠Version Examples

• 7.1.1-alpine3.22.0-1 - Initial release with FFmpeg 7.1.1 and Alpine 3.22.0
• 7.1.1-alpine3.22.0-2 - Rebuild of same versions (bug fixes, security patches)
• 7.1.1-alpine3.22.1-1 - Alpine Linux patch update
• 7.1.2-alpine3.22.0-1 - FFmpeg version update

When updates are available through automated dependency management, new releases are created with appropriate version tags.

⁠Links

• GitHub: https://github.com/RagedUnicorn/docker-ffmpeg⁠
• Issues: https://github.com/RagedUnicorn/docker-ffmpeg/issues⁠
• Releases: https://github.com/RagedUnicorn/docker-ffmpeg/releases⁠

⁠License

MIT License - See GitHub repository⁠ for details.