MediaProc

MediaProc is free and open source for manual, local usage.

> In the future, paid plans may be introduced for automation, pipelines, scheduling, and large-scale workflows to support long-term development. Core CLI commands will remain free.


``bash


Install

npm install -g @mediaproc/cli

Add Image Plugin to use image commands

mediaproc add image

Process images

mediaproc image resize photo.jpg --width 1920 --height 1080
mediaproc image convert *.jpg --format webp --quality 85

Add Video Plugin to use image commands

mediaproc add video

Process videos

mediaproc video compress movie.mp4 --quality high
mediaproc video trim video.mp4 --start 00:01:30 --end 00:03:45

Add Audio Plugin to use image commands

mediaproc add audio

Process audio

mediaproc audio convert song.wav --format mp3 --quality high
mediaproc audio normalize podcast.mp3 --target -16
`

> See Plugin Terminology Guide

Why MediaProc?

The Problem: Modern development workflows require multiple tools for media processing:

- FFmpeg for videos
- ImageMagick for images
- SoX for audio
- Each with different syntax, steep learning curves, and complex workflows

The Solution: MediaProc provides a unified CLI with consistent commands across all media types.

| Feature | Traditional | MediaProc |
| ----------------- | ------------------ | ------------------------------- |
| Tools Needed | 5+ separate tools | One tool |
| Installation | Complex setup | npm install -g @mediaproc/cli |
| Syntax | Different for each | Consistent everywhere |
| Extensibility | Limited | Plugin architecture |

Professional Support

MediaProc is free and open source.

If you need:

- help integrating MediaProc into your workflow
- custom pipelines or automation
- priority fixes or guidance

you can reach out via GitHub Discussions or email me at khanshariq92213@gmail.com.

Quick Start

`bash


Install CLI

npm install -g @mediaproc/cli

Install plugins (or use built-in ones)

mediaproc add image
mediaproc add video
mediaproc add audio

List available plugins

mediaproc list

Get help

mediaproc --help
mediaproc image --help
`

Available Plugins

$3

Included with CLI installation:

#### Image Plugin (46 commands)

`bash
mediaproc image resize photo.jpg --width 1920
mediaproc image convert *.png --format webp
mediaproc image compress image.jpg --quality 85
mediaproc image blur photo.jpg --sigma 10
mediaproc image watermark photo.jpg --text "Copyright 2026"
`

Commands: resize, crop, rotate, flip, convert, compress, optimize, blur, sharpen, grayscale, tint, watermark, thumbnail, and 36 more...

Formats: JPG, PNG, WebP, AVIF, TIFF, GIF, SVG

Full Image Plugin Documentation →

#### Video Plugin (7 commands)

`bash
mediaproc video compress movie.mp4 --quality medium
mediaproc video transcode video.mp4 --format webm --codec vp9
mediaproc video trim video.mp4 --start 10 --end 60
mediaproc video resize 4k-video.mp4 --preset 1080p
mediaproc video merge video1.mp4 video2.mp4 video3.mp4
mediaproc video extract movie.mp4 --type audio --output audio.mp3
`

Commands: compress, transcode, trim, resize, merge, extract

Formats: MP4, WebM, AVI, MKV, MOV

Full Video Plugin Documentation →

#### Audio Plugin (5 commands)

`bash
mediaproc audio convert song.wav --format mp3 --quality high
mediaproc audio normalize podcast.mp3 --target -16
mediaproc audio trim audio.wav --start 10 --duration 30
mediaproc audio merge track1.mp3 track2.mp3 track3.mp3
mediaproc audio extract video.mp4 --format mp3
`

Commands: convert, normalize, trim, merge, extract

Formats: MP3, AAC, WAV, FLAC, OGG, Opus

Full Audio Plugin Documentation →

$3

- Document - PDF,DOCX,MARKDOWN,PPTX,LATEX,etc processing (Q2 2026)
- Animation - GIF/Lottie optimization (Q2 2026)
- 3D - 3D model processing (Q3 2026)
- Stream - HLS/DASH streaming (Q3 2026)
- AI - AI-powered features (Q3 2026)

Plugin Management

`bash


List installed plugins

mediaproc list

Install plugins

mediaproc add

Remove plugins

mediaproc remove

Update plugins

mediaproc update # Update all
mediaproc update # Update specific

Browse available plugins

mediaproc plugins
`

Examples

$3

`bash


Resize for web

mediaproc image resize photo.jpg --width 1920 --height 1080 --fit cover

Batch convert to WebP

mediaproc image convert *.jpg --format webp --quality 85

Create thumbnails

mediaproc image thumbnail photo.jpg --size 256 --output thumb.jpg

Add watermark

mediaproc image watermark photo.jpg --text "© 2026" --position southeast

Optimize for web

mediaproc image optimize image.jpg --quality 80
`

$3

`bash


Compress video

mediaproc video compress movie.mp4 --quality medium --output compressed.mp4

Convert to WebM

mediaproc video transcode video.mp4 --format webm --codec vp9

Cut segment

mediaproc video trim long-video.mp4 --start 00:10:00 --end 00:15:00

Scale down

mediaproc video resize 4k-video.mp4 --preset 1080p

Extract audio

mediaproc video extract movie.mp4 --type audio --output soundtrack.mp3
`

$3

`bash


Convert to MP3

mediaproc audio convert song.wav --format mp3 --quality 320k

Normalize volume

mediaproc audio normalize podcast.mp3 --target -16 --output normalized.mp3

Merge tracks

mediaproc audio merge intro.mp3 main.mp3 outro.mp3 --output complete.mp3

Extract from video

mediaproc audio extract video.mp4 --format flac
`

CLI Commands

$3

- mediaproc add - Install plugin
- mediaproc remove - Uninstall plugin
- mediaproc list - List installed plugins
- mediaproc plugins - Browse available plugins
- mediaproc update [plugin] - Update plugin(s)

$3

- mediaproc --help - Show help
- mediaproc --help - Plugin-specific help
- mediaproc --version - Show version

Requirements

- Node.js >= 18.0.0
- FFmpeg (for video/audio plugins)

`bash
# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows
choco install ffmpeg
`

Development

$3

`
mediaproc/
├── src/ # Core CLI source
├── plugins/ # Official plugins
│ ├── image/ # Image processing
│ ├── video/ # Video processing
│ └── audio/ # Audio processing
├── docs/ # Documentation
└── web/ # Documentation website
`

$3

`bash


Install dependencies

pnpm install

Build CLI

pnpm build

Build all plugins

pnpm build:all

Test

pnpm test

Run locally

node dist/cli.js
``

$3

See Plugin Integration Guide for complete documentation on creating your own plugins.

Documentation

$3

- Installation Guide - Setup and configuration
- Universal Commands - CLI commands for all plugins

$3

- Plugin Integration Guide - Complete guide to creating plugins
- Plugin System Architecture - Understanding the plugin system
- Plugin Architecture - Technical architecture details
- Plugin Terminology - Key concepts and definitions
- Plugin Ideas - Inspiration for new plugins

$3

- Architecture Decisions - Design decisions and rationale
- Upcoming Features - Planned features and roadmap
- --explain flag: Command Transparency, Debugging, and Education

$3

- Contributing Guide - How to contribute
- Code of Conduct - Community guidelines
- Security Policy - Security and vulnerability reporting

📚 Full Documentation Website: https://docs-mediaproc.vercel.app

Roadmap

Current (v0.7.0):

- ✅ Core CLI with plugin system
- ✅ Image Plugin (51 commands)
- ✅ Video Plugin (6 commands)
- ✅ Audio Plugin (5 commands)

Q1 2026:

- 🚧 Document Plugin
- 🚧 Comprehensive testing
- 🚧 CI/CD pipeline

Q2 2026:

- 📋 Animation Plugin
- 📋 Metadata Plugin
- 📋 v1.0 Release

Q3-Q4 2026:

- 📋 3D Plugin
- 📋 Stream Plugin
- 📋 AI Plugin
- 📋 Plugin Marketplace

See Upcoming Features for details.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to contribute:

- 🐛 Report bugs
- 💡 Suggest features
- 📝 Improve documentation
- 🔧 Submit pull requests
- 🎨 Create plugins

Community

- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Twitter: @0xshariq

License

MIT © 0xshariq

See LICENSE for details.

---