pegome/video-timelapse-creator repository overview

⁠Video Timelapse Creator

Create timelapse videos from timestamped images with optimized parallel processing and automatic timestamp overlays.

⁠✨ Features

• 🚀 Fast Processing - Parallel image processing (100-300+ images/sec)
• ⏱️ Automatic Timestamps - Extracts and overlays timestamps from filenames
• 🎬 Multiple Resolutions - 480p, 720p, and 1080p output support
• 💾 Memory Efficient - Low memory footprint (~20-50 MB)
• 📊 Progress Tracking - Real-time progress bars and performance metrics
• 🐳 Docker Native - Ready to use, no setup required

⁠🚀 Quick Start

Create a timelapse video in one command:

docker run --rm \
  -v "$(pwd)/your_images:/input:ro" \
  -v "$(pwd)/output:/output" \
  pegome/video-timelapse-creator:latest \
  -i /input -o /output/timelapse.mp4 -q 720p

⁠📸 Image Requirements

Images must follow this naming pattern:

YYYYMMDD_HHmmss.jpg

Examples:

• 20240101_120000.jpg → 01/01/2024 12:00:00
• 20240315_153045.png → 15/03/2024 15:30:45

Supported formats: .jpg, .jpeg, .png

⁠📋 Parameters

⁠💡 Usage Examples

⁠Fast timelapse (0.5s per image)

docker run --rm \
  -v "$(pwd)/images:/input:ro" \
  -v "$(pwd)/output:/output" \
  pegome/video-timelapse-creator:latest \
  -i /input -o /output/fast.mp4 -p 500

⁠High quality 1080p

docker run --rm \
  -v "$(pwd)/images:/input:ro" \
  -v "$(pwd)/output:/output" \
  pegome/video-timelapse-creator:latest \
  -i /input -o /output/hd.mp4 -q 1080p

⁠Limit CPU usage (2 workers)

docker run --rm \
  -v "$(pwd)/images:/input:ro" \
  -v "$(pwd)/output:/output" \
  pegome/video-timelapse-creator:latest \
  -i /input -o /output/video.mp4 -w 2

⁠Docker Compose

version: '3.8'
services:
  video-creator:
    image: pegome/video-timelapse-creator:latest
    volumes:
      - ./input_images:/input:ro
      - ./output_videos:/output
    command: ["-i", "/input", "-o", "/output/timelapse.mp4", "-q", "720p"]

Run with: docker-compose up

⁠⚡ Performance

Typical performance on modern hardware:

• 500 images (720p): ~5 seconds
• Processing speed: 100-300+ images/second
• Memory usage: 20-50 MB
• Video codec: H.264 (MP4)

⁠🏗️ Pipeline Stages

1. Preparation - Scans and validates images
2. Timestamp Overlay - Parallel processing with multiple workers
3. Video Encoding - Single-pass FFmpeg encoding
4. Cleanup - Removes temporary files

⁠🌍 Supported Platforms

• linux/amd64 - Intel/AMD 64-bit
• linux/arm64 - ARM 64-bit (Apple Silicon, etc.)

⁠📦 What's Inside

• Python 3.11
• FFmpeg
• Pillow (image processing)
• tqdm (progress bars)
• psutil (system monitoring)

⁠🔗 Links

• Source Code: https://github.com/paragpatel/Time-Lapse-Video-Generator⁠

⁠📄 License

MIT License

⁠👤 Author

pegome