node-ffmpeg 1.0.0
node-ffmpeg 1.0.0
The first major release modernizes the original ffmpeg package while preserving its familiar callable, Promise, callback, and fluent APIs.
Highlights
- Rewritten in strict TypeScript for Node.js 24+
- Native ESM and backward-compatible CommonJS exports
- Structured
ffprobeJSON metadata - Safe process arguments with no shell interpolation
- Native Promises,
AbortSignal, timeouts, progress, and lifecycle events - Configurable
ffmpegandffprobeexecutable paths - Fixed paths with spaces, Unicode paths, codec copy, bitrates, watermarks, frame extraction, metadata, and output buffering
- Zero runtime dependencies
- 136 automated tests plus real-FFmpeg integration coverage
Install
npm install ffmpeg@1.0.0Node.js 24 or newer and local ffmpeg/ffprobe executables are required.
Documentation
See CHANGELOG.md for the detailed change list.