fluent-ffmpeg

fluent-ffmpeg is a Node.js library that provides a fluent, chainable API for interacting with the FFmpeg multimedia framework, created by Stefan Schaermeli. It abstracts away the complexity of constructing FFmpeg command-line arguments and parsing output, making it easy to perform common multimedia operations like transcoding, format conversion, thumbnail extraction, metadata querying, and video processing from JavaScript code. Instead of manually building complex command-line strings with dozens of flags and worrying about proper quoting and escaping, developers use a method-chaining API that reads almost like natural language. Key features include: a fluent API for building FFmpeg commands (ffmpeg(input).toFormat('mp4').saveToFile(output)), support for multiple input files and complex filter graphs (using the complexFilter method for multi-input operations like overlays, picture-in-picture, and audio mixing), preset and plugin support for reusable configuration patterns, screenshot and thumbnail extraction (capturing frames at specific timestamps or intervals), metadata extraction (querying video duration, codec, resolution, bitrate, and frame count), progress tracking (real-time progress events during transcoding, reporting percentage complete, frames processed, and current timestamp), timeout and kill functionality (aborting long-running operations), support for reading from and writing to streams (processing media data from network streams, file streams, or buffers without requiring intermediate files), support for live streaming output (RTMP, HLS, DASH), support for custom FFmpeg and FFprobe binary paths (useful for bundled or containerized deployments), and error handling with detailed FFmpeg stderr output. As of 2026, fluent-ffmpeg has over 2,800 stars.