Python + FFmpeg Docker Image

🎯 What is this?

🚀 Why use this image?

🎬 Perfect for

📦 Quick Start

Basic Usage

# Run interactive Python shell with FFmpeg available
docker run -it eswardudi/python-ffmpeg python
# Run a Python script that uses FFmpeg
docker run --rm -v $(pwd):/app -w /app eswardudi/python-ffmpeg python your_script.py
# Execute FFmpeg directly
docker run --rm -v $(pwd):/media eswardudi/python-ffmpeg ffmpeg -i input.mp4 output.mp3

Using as Base Image

FROM eswardudi/python-ffmpeg:latest
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "main.py"]

Docker Compose Example

version: "3.8"
services:
 video-processor:
 image: eswardudi/python-ffmpeg:latest
 volumes:
 - ./media:/app/media
 - ./scripts:/app
 working_dir: /app
 command: python process_videos.py

💻 Usage Examples

Using subprocess for FFmpeg Commands

import subprocess
import os
def convert_video(input_path, output_path):
 """Convert video with H.264 encoding"""
 cmd = [
 'ffmpeg', '-i', input_path,
 '-c:v', 'libx264',
 '-c:a', 'aac',
 '-preset', 'medium',
 '-crf', '23',
 '-y', output_path
 ]
 subprocess.run(cmd, check=True)
def batch_convert(input_dir, output_dir):
 """Batch convert all MP4 files in directory"""
 for filename in os.listdir(input_dir):
 if filename.endswith('.mp4'):
 input_path = os.path.join(input_dir, filename)
 output_path = os.path.join(output_dir, filename.replace('.mp4', '.avi'))
 convert_video(input_path, output_path)
 print(f"Converted {filename}")

🏷️ Available Tags

🛠️ Image Details

📋 Best Practices

Performance Optimization

# Mount volumes for better I/O performance
docker run --rm -v $(pwd)/input:/input -v $(pwd)/output:/output \
 eswardudi/python-ffmpeg python process.py
# Use tmpfs for temporary files
docker run --rm --tmpfs /tmp:rw,noexec,nosuid,size=1g \
 -v $(pwd):/app eswardudi/python-ffmpeg python script.py

Resource Management

# Set memory limits for large video processing
docker run --rm -m 2g --cpus="2.0" \
 -v $(pwd):/app eswardudi/python-ffmpeg python heavy_processing.py

Security Considerations

# Run as non-root user
docker run --rm --user $(id -u):$(id -g) \
 -v $(pwd):/app eswardudi/python-ffmpeg python script.py

🔧 Building Locally

# Clone the repository
git clone https://github.com/eswar-7116/python-ffmpeg-docker.git
cd python-ffmpeg-docker
# Build the image
docker build -t python-ffmpeg .
# Test the build
docker run --rm python-ffmpeg python -c "import subprocess; print(subprocess.run(['ffmpeg', '-version'], capture_output=True, text=True).stdout)"

🧪 Testing

# Run the test suite
docker run --rm -v $(pwd)/tests:/tests python-ffmpeg python -m pytest /tests
# Quick verification
docker run --rm python-ffmpeg python -c "
import subprocess
import sys
try:
 result = subprocess.run(['ffmpeg', '-version'], capture_output=True, text=True, check=True)
 print('✅ FFmpeg is working!')
 print(f'Version: {result.stdout.split()[2]}')
except Exception as e:
 print('❌ FFmpeg test failed:', e)
 sys.exit(1)
"

📝 License

🙏 Acknowledgments

📞 Support