Skip to content

node-ffmpeg 1.0.0

Choose a tag to compare

@damianociarla damianociarla released this 20 Aug 06:45
· 7 commits to main since this release
9e81dcf

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 ffprobe JSON metadata
  • Safe process arguments with no shell interpolation
  • Native Promises, AbortSignal, timeouts, progress, and lifecycle events
  • Configurable ffmpeg and ffprobe executable 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.0

Node.js 24 or newer and local ffmpeg/ffprobe executables are required.

Documentation

See CHANGELOG.md for the detailed change list.