with one click
media-processing
Media processing utilities for images, audio, and video using FFmpeg and ImageMagick. Use when working with media conversion, optimization, or batch processing tasks.
Menu
Media processing utilities for images, audio, and video using FFmpeg and ImageMagick. Use when working with media conversion, optimization, or batch processing tasks.
Manage Git commits using conventional commit format with atomic staging. Always generate plain git commands before running them and offer to let the user run them manually.
Create AGENTS.md files for project-specific inline rules. Use when adding small, project-specific instructions that should be committed in repos.
Core software engineering principles for code style, documentation, and development workflow. Applies when editing code, working in software repositories, or performing software development tasks.
Python development guidelines and best practices. Use when working with Python code.
Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJS, FastAPI, Django), databases (PostgreSQL, MongoDB, Redis), APIs (REST, GraphQL, gRPC), authentication (OAuth 2.1, JWT), testing strategies, security best practices (OWASP Top 10), performance optimization, scalability patterns (microservices, caching, sharding), DevOps practices (Docker, Kubernetes, CI/CD), and monitoring. Use when designing APIs, implementing authentication, optimizing database queries, setting up CI/CD pipelines, handling security vulnerabilities, building microservices, or developing production-ready backend systems.
Build command-line interfaces with async-first design, composable commands, and proper output formatting. Use when creating CLI tools, commands, or interactive terminal applications.
| name | media-processing |
| description | Media processing utilities for images, audio, and video using FFmpeg and ImageMagick. Use when working with media conversion, optimization, or batch processing tasks. |
Tools and workflows for working with images, audio, and video in a repeatable, scriptable way using standard CLI tools (FFmpeg, ImageMagick) and Python helpers.
Image workflows
Media conversion
web, archive, and mobile use casesVideo optimization
Scripts live in scripts/ and are intended to be run directly from a shell:
batch_resize.py
fit, fill, cover, exact, thumbnail)media_convert.py
web, archive, mobile).mov → .mp4, .wav → .mp3)video_optimize.py
See scripts/requirements.txt for environment expectations (Python 3.10+, FFmpeg, ImageMagick) and system installation hints.
Check dependencies first
ffmpeg and ffprobe are installed and on PATH for video/audio tasks.magick (ImageMagick) is installed and on PATH for image tasks.Prefer dry-runs when exploring
--dry-run and/or --verbose flags on scripts to inspect generated commands before running them.Keep originals
--output ./out/) to avoid accidental overwrites.Document workflows
just, npm scripts, or CI jobs) so they’re repeatable.For deeper tool-specific notes (placeholders for now, extend as needed), see:
references/ffmpeg-encoding.md – FFmpeg encoding patterns and flagsreferences/ffmpeg-filters.md – Common filter graphs (scale, crop, audio filters)references/ffmpeg-streaming.md – Streaming-friendly settings and HLS/DASH tipsreferences/format-compatibility.md – Container/codec compatibility notes (web, mobile, desktop)references/imagemagick-batch.md – Batch image processing patterns with ImageMagickreferences/imagemagick-editing.md – Image editing operations (crop, resize, composite, text, etc.)