VidGear：Python 视频处理的一站式框架
文章目录
- VidGear：Python 视频处理的一站式框架
VidGear：Python 视频处理的一站式框架
abhiTronix/vidgear 目前收获了 3,713 个 Star：
VidGear 是一个跨平台的 Python 视频处理框架，底层整合了 OpenCV、FFmpeg、ZeroMQ、picamera2 等库，对外暴露统一的 API。项目的理念是"Write Less and Accomplish More"，即用更少的代码完成视频捕获、处理、编码、传输和流媒体的完整链路。
整个框架由多个独立模块组成，每个模块被称为一个 Gear，分别处理不同场景下的视频任务。
视频捕获方面，CamGear 负责从摄像头、网络流和视频网站抓取帧数据，内部采用多线程队列模式保证读取效率。FFGear 基于 FFmpeg 实现硬件加速解码，支持 GPU 解码、逐帧元数据提取和复杂滤镜管线。PiGear 专为树莓派优化，封装了 picamera2 库。ScreenGear 则用于屏幕录制，支持多显示器和多种后端。VideoGear 是上述捕获 API 的统一入口，内置了视频稳定器功能。
视频编码与流媒体方面，WriteGear 提供 FFmpeg 封装，支持视频文件编码、RTSP/RTP/RTMP 推流以及音视频混流。StreamGear 负责生成 MPEG-DASH 和 Apple HLS 自适应流媒体片段。WebGear 基于 Starlette 和 Uvicorn 搭建 ASGI 视频广播服务器，通过 MJPEG 格式向浏览器推送实时画面。WebGear_RTC 则使用 WebRTC 技术实现点对点低延迟传输。
网络传输方面，NetGear 基于 ZeroMQ 实现视频帧在不同设备间的实时传输，支持双向数据通道和多服务端/客户端架构，可选 SSH 隧道和加密传输。NetGear_Async 是其异步版本，内存占用约为同步版的三分之一，基于 uvloop 事件循环实现高速帧传输。
安装 VidGear 可以直接通过 pip：
pipinstallvidgear使用时只需导入对应模块即可。以下是一个 CamGear 的基础示例：
fromvidgear.gearsimportCamGearimportcv2 stream=CamGear(source=0).start()whileTrue:frame=stream.read()ifframeisNone:breakcv2.imshow("Output",frame)ifcv2.waitKey(1)&0xFF==ord("q"):breakstream.stop()cv2.destroyAllWindows()FFGear 的硬件加速解码示例：
fromvidgear.gearsimportFFGear stream=FFGear(source="test.mp4",frame_format="bgr24").start()whileTrue:frame=stream.read()ifframeisNone:breakstream.stop()WebGear 搭建本地视频服务器的示例：
importuvicornfromvidgear.gears.asyncioimportWebGear web=WebGear(source="video.mp4",logging=True)uvicorn.run(web(),host="localhost",port=8000)web.shutdown()VidGear 的每个 Gear 都提供了详尽的中文/英文文档，覆盖安装、API 用法和进阶配置。如果你在 Python 项目中需要处理视频流相关任务，这个框架可以帮你省去大量底层库的对接工作。
/英文文档，覆盖安装、API 用法和进阶配置。如果你在 Python 项目中需要处理视频流相关任务，这个框架可以帮你省去大量底层库的对接工作。