kkroening/ffmpeg-python
Ffmpeg Python
ffmpeg-python is a Python wrapper that translates programmatic method calls into command-line arguments for executing FFmpeg media processing tasks. It functions as a multimedia transcoding interface and a media stream capture tool, allowing for the recording of live audio and video from hardware devices and network sources.
The library features a fluent interface for constructing complex directed graphs of audio and video filters through method chaining. It also includes an FFprobe metadata extractor that retrieves structured technical properties from media files and returns them as Python dictionaries.
The project covers a broad range of media operations, including format conversion, automated video generation from image sequences, and the extraction of raw frames into numerical arrays. It supports advanced audio engineering tasks, complex filter application with multi-input and multi-output handling, and the relaying of network streams.
Features
- CLI Wrappers - Provides a programmatic Python interface that translates method calls into FFmpeg command-line arguments.
- FFmpeg Wrappers - Functions as a Python wrapper that translates programmatic calls into FFmpeg command-line arguments.
- Media Filter Application - Implements programmatic scaling, cropping, and volume adjustments through a fluent filter interface.
- Command Execution Engines - Translates defined filter graphs into executable command lines to process media files.
- Media Metadata Extraction - Provides programmatic access to FFprobe for extracting technical metadata like codecs and resolution from media files.
- Filter Graphs - Represents media processing pipelines as directed graphs of interconnected filter nodes before execution.
- Fluent Graph Builders - Implements a fluent interface for building complex directed graphs of audio and video filters through method chaining.
- Filter Graph Applications - Allows the construction and application of complex audio and video filter chains using FFmpeg's libavfilter.
- Live Media Streaming - Captures and transmits live audio and video from hardware devices or network sources using FFmpeg protocols.
- Media Metadata Extractors - Extracts structured technical properties from media files using FFprobe.
- Media Metadata Parsers - Converts the text output of FFprobe into structured Python dictionaries and objects.
- Media Transcoding - Changes codecs, bitrates, and file formats of media assets to ensure cross-platform compatibility.
- Programmatic Video Frameworks - Enables the construction of complex audio and video filter pipelines using Python code.
- FFmpeg Transcoders - Provides a programmatic interface for changing codecs, bitrates, and formats of media files via FFmpeg.
- Media Filter Pipelines - Applies independent filters to separate video and audio streams before concatenating them into a single file.
- Fluent Command Generation - Builds complex media processing commands through a chainable API that incrementally accumulates arguments.
- Subprocess Management - Manages the spawning and execution of external FFmpeg system processes and their I/O streams.
- Live Capture and Recording - Records live video and audio directly from system hardware devices such as webcams.
- Custom Processing Filters - Executes filters by name to support multi-input streams and dynamic expressions.
- Filter Syntax Serializers - Serializes complex programmatic filter chains into the specific string syntax required by the FFmpeg binary.
- Image-to-Video Sequencing - Creates video files from sequences of image frames using pattern matching and specified framerates.
- Stream Relaying - Reads RTSP streams and forwards raw packets to TCP sockets for network relaying.
- Media Stream Processing - Decodes video frames or raw audio into numerical arrays for data science and machine learning analysis.
- Independent Stream Processing - Provides the ability to separate and apply independent filters to audio and video streams before merging them.
- Array-Based Frame Processing - Extracts individual frames of raw video and audio data into numerical arrays for external analysis.
- Multi-Input Media Filters - Passes multiple input streams to a single filter to overlay content.
- Multi-Output Media Filters - Splits a stream into multiple outputs to enable parallel processing branches.
- Multi-Output Merging - Allows combining several output streams into a single command that writes them simultaneously.
- Programmatic Video Generation - Creates video files from sequences of images or raw data frames using programmatic controls.
- Video Streaming - Serves local video files as live streams over HTTP for remote playback.
- Thumbnail Generators - Generates representative video thumbnails by capturing and scaling frames at specific timestamps.
- Video Frame Extraction - Extracts individual static frames from a video stream as images or raw data pipes.
- Fluent Interfaces - Implements a fluent API using method chaining to programmatically define media processing sequences.
- Command String Generators - Generates a command-line string from a filter graph for inspection or manual execution.
