Audio Plugin
Professional audio processing plugin for MediaProc CLI. Convert, extract, trim, merge, and normalize audio files with FFmpeg.
Features
- 🔄 Convert - Convert between audio formats (MP3, AAC, WAV, FLAC, OGG, Opus)
- 🎵 Extract - Extract audio tracks from video files
- ✂️ Trim - Cut audio to specific time ranges with fade effects
- 🔗 Merge - Concatenate multiple audio files with crossfade
- 📊 Normalize - EBU R128 loudness normalization for consistent levels
Installation
``bash
npm install -g @mediaproc/audio
`
Or via MediaProc CLI:
`bash
mediaproc add audio
`
Requirements
- FFmpeg 4.0+ with audio codecs support
- Node.js 18+
Check if FFmpeg is installed:
`bash
ffmpeg -version
`
Commands
$3
Convert audio files between different formats with quality control.
Supported Formats: MP3, AAC, WAV, FLAC, OGG, Opus, M4A
`bash
Basic conversion
mediaproc audio convert input.wav -f mp3
High-quality conversion
mediaproc audio convert input.flac -f mp3 -b 320k
Lossless conversion
mediaproc audio convert input.wav -f flac -q lossless
Change sample rate and channels
mediaproc audio convert input.mp3 -f wav -s 48000 -c 2
Batch convert folder
mediaproc audio convert audio-files/ -f aac -o output/
`
Options:
-
-o, --output
- Output file/directory
- -f, --format - Output format (mp3, aac, wav, flac, ogg, opus, m4a)
- -b, --bitrate - Audio bitrate (e.g., 128k, 192k, 320k)
- -q, --quality - Quality preset: low, medium, high, lossless
- -s, --sample-rate - Sample rate in Hz (44100, 48000)
- -c, --channels - Channels: 1 (mono), 2 (stereo)---
$3
Extract audio tracks from video files to standalone audio files.
Supported Video Formats: MP4, MKV, AVI, MOV, WebM, FLV
`bash
Extract as MP3 (default)
mediaproc audio extract video.mp4Extract as high-quality AAC
mediaproc audio extract video.mp4 -f aac -b 256kExtract as lossless FLAC
mediaproc audio extract video.mkv -f flac -q losslessExtract as mono for voice
mediaproc audio extract video.mp4 -f mp3 --channels 1Batch extract from folder
mediaproc audio extract videos/ -f mp3 -o audio-tracks/
`Options:
-
-o, --output - Output file/directory
- -f, --format - Output format (mp3, aac, wav, flac, opus, ogg)
- -b, --bitrate - Audio bitrate
- -q, --quality - Quality preset
- --sample-rate - Sample rate
- --channels - Number of channels---
$3
Trim audio files to specific time ranges with optional fade effects.
`bash
Trim by time range
mediaproc audio trim audio.mp3 --start 00:01:00 --end 00:02:00Extract first 30 seconds
mediaproc audio trim audio.mp3 --duration 30Trim from 30s for 60s
mediaproc audio trim audio.mp3 -s 30 -d 60Add fade effects
mediaproc audio trim audio.mp3 -s 60 -d 120 --fade-in 2 --fade-out 3Fast mode (stream copy, no re-encoding)
mediaproc audio trim audio.mp3 --start 30 --duration 60 --fastBatch trim all files
mediaproc audio trim folder/ -s 10 -d 30 -o output/
`Options:
-
-o, --output - Output file/directory
- -s, --start