An open-source media backend platform for ingesting, transcoding, storing, and delivering video and image assets via a global CDN — with built-in live streaming support over SRT.

MMDrive is a self-hostable media infrastructure layer. It handles the full lifecycle of media assets — from upload or live stream ingest, through transcoding and optimization, to CDN-backed delivery. Built on Motia, it uses an event-driven step architecture making each pipeline stage independently scalable and observable.

• SRT live stream ingest (per stream key, per device)
• HTTP multipart upload for video and image assets
• R2 / S3 direct upload with multipart support
• Webhook emission on ingest completion

• Multi-rendition HLS output (360p, 480p, 720p, 1080p)
• Multi-codec support — H.264, H.265, AV1, VP9
• Per-codec master playlist generation
• Thumbnail extraction (by timestamp or percentage)
• Image resize and optimization (WebP, AVIF)
• Aspect ratio preservation with letterbox padding
• Original recording captured alongside HLS output

• Cloudflare R2 as primary object store
• Live segment sync to R2 as segments close
• Automatic VOD packaging on stream end
• Asset deduplication via content hash / slug
• Structured paths: /{slug}/{deviceId}/hls/, /original/, /thumbnails/

• Signed URL generation with configurable TTL
• HTTP byte-range streaming support
• HLS manifest rewriting with CDN base URL injection
• Image dimension and metadata API
• Video metadata API (duration, resolution, codec info)
• Resolution negotiation per request

• Asset CRUD — list, fetch, upload, delete
• Stream provisioning — start, stop, status
• Health endpoint for infrastructure monitoring
• Project-based folder auto-creation
• Anonymous share links with expiration

• Analytics
• Adaptive Bitrate Streaming (ABR)
• Containerized via Docker
• CI/CD via GitHub Actions

• SRT ingest with FFmpeg
• Multi-rendition HLS transcoding
• H.264 / AV1 / VP9 codec support
• R2 storage sync
• HLS master playlist generation
• Thumbnail generation
• Asset metadata API
• Stream start / stop / status API
• VOD finalization on stream end
• Signed URL delivery
• Image optimization (WebP / AVIF)

• OAuth 2.0 authentication
• Project-based organization
• Anonymous share links with TTL
• Analytics dashboard
• Push notifications
• PWA shell

• Multi-node Docker Swarm deployment
• Horizontal FFmpeg worker scaling
• Segment purge and storage lifecycle policies
• End-to-end test suite
• Prometheus + Grafana observability

• Docker with Swarm mode
• Cloudflare R2 bucket credentials

docker swarm init --advertise-addr <MANAGER-IP>

docker swarm join --token <WORKER-TOKEN> <MANAGER-IP>:2377

docker node ls

# Mount static and .data into your deployment path upload static, .data into /root/mmdrive

docker stack deploy --compose-file docker-compose.prod.yml mmdrive

docker service scale mmdrive_app=2

docker service ls docker service ps mmdrive_app

• gitleaks — secret scanning in CI

Published under the GNU GPLv3 license.