Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/abhiTronix/vidgear

A High-performance cross-platform Video Processing Python framework powerpacked with unique trailblazing features :fire:
https://github.com/abhiTronix/vidgear

dash ffmpeg framework hls live-streaming multithreading opencv peer-to-peer python real-time screen-capture streaming twitch video video-processing video-stabilization video-streaming webrtc-video youtube yt-dlp

Last synced: about 1 month ago
JSON representation

A High-performance cross-platform Video Processing Python framework powerpacked with unique trailblazing features :fire:

Lists

README 

        





  VidGear





  VidGear tagline







[Releases][release]   |   [Gears][gears]   |   [Documentation][docs]   |   [Installation][installation]   |   [License](#copyright)



[![Build Status][github-cli]][github-flow] [![Codecov branch][codecov]][code] [![Azure DevOps builds (branch)][azure-badge]][azure-pipeline]



[![Glitter chat][gitter-bagde]][gitter] [![Build Status][appveyor]][app] [![PyPi version][pypi-badge]][pypi]



[![Code Style][black-badge]][black]






 



VidGear is a **High-Performance Video Processing Python Library** that provides an easy-to-use, highly extensible, thoroughly optimised **Multi-Threaded + Asyncio API Framework** on top of many state-of-the-art specialized libraries like _[OpenCV][opencv], [FFmpeg][ffmpeg], [ZeroMQ][zmq], [picamera][picamera], [starlette][starlette], [yt_dlp][yt_dlp], [pyscreenshot][pyscreenshot], [dxcam][dxcam], [aiortc][aiortc] and [python-mss][mss]_ serving at its backend, and enable us to flexibly exploit their internal parameters and methods, while silently delivering **robust error-handling and real-time performance 🔥**



VidGear primarily focuses on simplicity, and thereby lets programmers and software developers to easily integrate and perform Complex Video Processing Tasks, in just a few lines of code.



 



The following **functional block diagram** clearly depicts the generalized functioning of VidGear APIs:





  @Vidgear Functional Block Diagram




 



# Table of Contents



- [**TL;DR**](#tldr)

- [**Getting Started**](#getting-started)

- [**Gears: What are these?**](#gears-what-are-these)

  - [**CamGear**](#camgear)

  - [**PiGear**](#pigear)

  - [**VideoGear**](#videogear)

  - [**ScreenGear**](#screengear)

  - [**WriteGear**](#writegear)

  - [**StreamGear**](#streamgear)

  - [**NetGear**](#netgear)

  - [**WebGear**](#webgear)

  - [**WebGear_RTC**](#webgear_rtc)

  - [**NetGear_Async**](#netgear_async)

- [**Contributions**](#contributions)

- [**Donations**](#donations)

- [**Citation**](#citation)

- [**Copyright**](#copyright)



 



 



## TL;DR



#### What is vidgear?



> _"VidGear is a cross-platform High-Performance Framework that provides an one-stop **Video-Processing** solution for building complex real-time media applications in python."_



#### What does it do?



> _"VidGear can read, write, process, send & receive video files/frames/streams from/to various devices in real-time, and [**faster**][tqm-doc] than underline libraries."_



#### What is its purpose?



> _"Write Less and Accomplish More"_ — **VidGear's Motto**



> _"Built with simplicity in mind, VidGear lets programmers and software developers to easily integrate and perform **Complex Video-Processing Tasks** in their existing or newer applications without going through hefty documentation and in just a [**few lines of code**][switch_from_cv]. Beneficial for both, if you're new to programming with Python language or already a pro at it."_



 



 



## Getting Started



If this is your first time using VidGear, head straight to the [Installation ➶][installation] to install VidGear.



Once you have VidGear installed, **Checkout its Well-Documented [Function-Specific Gears ➶][gears]**



Also, if you're already familiar with [OpenCV][opencv] library, then see [Switching from OpenCV Library ➶][switch_from_cv]



Or, if you're just getting started with OpenCV-Python programming, then refer this [FAQ ➶](https://abhitronix.github.io/vidgear/latest/help/general_faqs/#im-new-to-python-programming-or-its-usage-in-opencv-library-how-to-use-vidgear-in-my-projects)



 



 



## Gears: What are these?



> **VidGear is built with multiple APIs a.k.a [Gears][gears], each with some unique functionality.**



Each API is designed exclusively to handle/control/process different data-specific & device-specific video streams, network streams, and media encoders/decoders. These APIs provides the user an easy-to-use, dynamic, extensible, and exposed Multi-Threaded + Asyncio optimized internal layer above state-of-the-art libraries to work with, while silently delivering robust error-handling.



**These Gears can be classified as follows:**



**A. Video-Capture Gears:**



- [**CamGear:**](#camgear) Multi-Threaded API targeting various IP-USB-Cameras/Network-Streams/Streaming-Sites-URLs.

- [**PiGear:**](#pigear) Multi-Threaded API targeting various Raspberry-Pi Camera Modules.

- [**ScreenGear:**](#screengear) High-performance API targeting rapid Screencasting Capabilities.

- [**VideoGear:**](#videogear) Common Video-Capture API with internal [Video Stabilizer](https://abhitronix.github.io/vidgear/latest/gears/stabilizer/overview/) wrapper.



**B. Video-Writer Gears:**



- [**WriteGear:**](#writegear) Handles Lossless Video-Writer for file/stream/frames Encoding and Compression.



**C. Streaming Gears:**



- [**StreamGear**](#streamgear): Handles Transcoding of High-Quality, Dynamic & Adaptive Streaming Formats.



- **Asynchronous I/O Streaming Gear:**



  - [**WebGear:**](#webgear) ASGI Video-Server that broadcasts Live MJPEG-Frames to any web-browser on the network.

  - [**WebGear_RTC:**](#webgear_rtc) Real-time Asyncio WebRTC media server for streaming directly to peer clients over the network.



**D. Network Gears:**



- [**NetGear:**](#netgear) Handles High-Performance Video-Frames & Data Transfer between interconnecting systems over the network.



- **Asynchronous I/O Network Gear:**



  - [**NetGear_Async:**](#netgear_async) Immensely Memory-Efficient Asyncio Video-Frames Network Messaging Framework.



 



 



## CamGear





  CamGear Functional Block Diagram




> _CamGear can grab ultra-fast frames from a diverse range of file-formats/devices/streams, which includes almost any IP-USB Cameras, multimedia video file-formats ([*upto 4k tested*][test-4k]), various network stream protocols such as `http(s), rtp, rtsp, rtmp, mms, etc.`, and GStreamer's pipelines, plus direct support for live video streaming sites like YouTube, Twitch, LiveStream, Dailymotion etc._



CamGear provides a flexible, high-level, multi-threaded framework around OpenCV's [VideoCapture class][opencv-vc] with access almost all of its available parameters. CamGear internally implements [`yt_dlp`][yt_dlp] backend class for seamlessly pipelining live video-frames and metadata from various streaming services like [YouTube][youtube-doc], [Twitch][piping-live-videos], and [many more ➶](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md#supported-sites). Furthermore, its framework relies exclusively on [**Threaded Queue mode**][tqm-doc] for ultra-fast, error-free, and synchronized video-frame handling.



### CamGear API Guide:



[**>>> Usage Guide**][camgear-doc]



 



 



## VideoGear



> _VideoGear API provides a special internal wrapper around VidGear's exclusive [**Video Stabilizer**][stabilizer-doc] class._



VideoGear also acts as a Common Video-Capture API that provides internal access for both [CamGear](#camgear) and [PiGear](#pigear) APIs and their parameters with an exclusive `enablePiCamera` boolean flag.



VideoGear is ideal when you need to switch to different video sources without changing your code much. Also, it enables easy stabilization for various video-streams _(real-time or not)_ with minimum effort and writing way fewer lines of code.



**Below is a snapshot of a VideoGear Stabilizer in action (_See its detailed usage [here][stabilizer-doc-ex]_):**





  VideoGear Stabilizer in action!

  


  Original Video Courtesy @SIGGRAPH2013




**Code to generate above result:**



```python

# import required libraries

from vidgear.gears import VideoGear

import numpy as np

import cv2



# open any valid video stream with stabilization enabled(`stabilize = True`)

stream_stab = VideoGear(source="test.mp4", stabilize=True).start()



# open same stream without stabilization for comparison

stream_org = VideoGear(source="test.mp4").start()



# loop over

while True:



    # read stabilized frames

    frame_stab = stream_stab.read()



    # check for stabilized frame if Nonetype

    if frame_stab is None:

        break



    # read un-stabilized frame

    frame_org = stream_org.read()



    # concatenate both frames

    output_frame = np.concatenate((frame_org, frame_stab), axis=1)



    # put text over concatenated frame

    cv2.putText(

        output_frame,

        "Before",

        (10, output_frame.shape[0] - 10),

        cv2.FONT_HERSHEY_SIMPLEX,

        0.6,

        (0, 255, 0),

        2,

    )

    cv2.putText(

        output_frame,

        "After",

        (output_frame.shape[1] // 2 + 10, output_frame.shape[0] - 10),

        cv2.FONT_HERSHEY_SIMPLEX,

        0.6,

        (0, 255, 0),

        2,

    )



    # Show output window

    cv2.imshow("Stabilized Frame", output_frame)



    # check for 'q' key if pressed

    key = cv2.waitKey(1) & 0xFF

    if key == ord("q"):

        break



# close output window

cv2.destroyAllWindows()



# safely close both video streams

stream_org.stop()

stream_stab.stop()

```



### VideoGear API Guide:



[**>>> Usage Guide**][videogear-doc]



 



 



## PiGear





  PiGear




> _PiGear is similar to CamGear but made to support various Raspberry Pi Camera Modules _(such as [OmniVision OV5647 Camera Module][ov5647-picam] and [Sony IMX219 Camera Module][imx219-picam])_._



PiGear provides a flexible multi-threaded framework around complete [picamera](https://picamera.readthedocs.io/en/release-1.13/index.html) python library, and provide us the ability to exploit almost all of its parameters like `brightness, saturation, sensor_mode, iso, exposure, etc.` effortlessly. Furthermore, PiGear also supports multiple camera modules, such as in the case of Raspberry-Pi Compute Module IO boards.



Best of all, PiGear contains **Threaded Internal Timer** - that silently keeps active track of any frozen-threads/hardware-failures and exit safely, if any does occur. That means that if you're running PiGear API in your script and someone accidentally pulls the Camera-Module cable out, instead of going into possible kernel panic, API will exit safely to save resources.



**Code to open picamera stream with variable parameters in PiGear API:**



```python

# import required libraries

from vidgear.gears import PiGear

import cv2



# add various Picamera tweak parameters to dictionary

options = {

    "hflip": True,

    "exposure_mode": "auto",

    "iso": 800,

    "exposure_compensation": 15,

    "awb_mode": "horizon",

    "sensor_mode": 0,

}



# open pi video stream with defined parameters

stream = PiGear(resolution=(640, 480), framerate=60, logging=True, **options).start()



# loop over

while True:



    # read frames from stream

    frame = stream.read()



    # check for frame if Nonetype

    if frame is None:

        break



    # {do something with the frame here}



    # Show output window

    cv2.imshow("Output Frame", frame)



    # check for 'q' key if pressed

    key = cv2.waitKey(1) & 0xFF

    if key == ord("q"):

        break



# close output window

cv2.destroyAllWindows()



# safely close video stream

stream.stop()



```



### PiGear API Guide:



[**>>> Usage Guide**][pigear-doc]



 



 



## ScreenGear



> _ScreenGear is designed exclusively for targeting rapid Screencasting Capabilities, which means it can grab frames from your monitor in real-time, either by defining an area on the computer screen or full-screen, at the expense of inconsiderable latency. ScreenGear also seamlessly support frame capturing from multiple monitors as well as supports multiple backends._



ScreenGear implements a Lightning-Fast API wrapper around [**dxcam**][dxcam], [**pyscreenshot**][pyscreenshot] & [**python-mss**][mss] python libraries and also supports an easy and flexible direct internal parameters manipulation.



**Below is a snapshot of a ScreenGear API in action:**





  ScreenGear in action!




**Code to generate the above results:**



```python

# import required libraries

from vidgear.gears import ScreenGear

import cv2



# open video stream with default parameters

stream = ScreenGear().start()



# loop over

while True:



    # read frames from stream

    frame = stream.read()



    # check for frame if Nonetype

    if frame is None:

        break



    # {do something with the frame here}



    # Show output window

    cv2.imshow("Output Frame", frame)



    # check for 'q' key if pressed

    key = cv2.waitKey(1) & 0xFF

    if key == ord("q"):

        break



# close output window

cv2.destroyAllWindows()



# safely close video stream

stream.stop()

```



### ScreenGear API Guide:



[**>>> Usage Guide**][screengear-doc]



 



 



## WriteGear





  WriteGear Functional Block Diagram




> _WriteGear handles various powerful Video-Writer Tools that provide us the freedom to do almost anything imaginable with multimedia data._



WriteGear API provides a complete, flexible, and robust wrapper around [**FFmpeg**][ffmpeg], a leading multimedia framework. WriteGear can process real-time frames into a lossless compressed video-file with any suitable specifications _(such as`bitrate, codec, framerate, resolution, subtitles,  etc.`)_.



WriteGear also supports streaming with traditional protocols such as [RTSP/RTP][rtsp-ex], RTMP. It is powerful enough to perform complex tasks such as [Live-Streaming][live-stream] _(such as for Twitch, YouTube etc.)_ and [Multiplexing Video-Audio][live-audio-doc] with real-time frames in just few lines of code.



Best of all, WriteGear grants users the complete freedom to play with any FFmpeg parameter with its exclusive **Custom Commands function** _(see this [doc][custom-command-doc])_ without relying on any third-party API.



In addition to this, WriteGear also provides flexible access to [**OpenCV's VideoWriter API**][opencv-writer] tools for video-frames encoding without compression.



**WriteGear primarily operates in the following two modes:**



- **Compression Mode:** In this mode, WriteGear utilizes powerful [**FFmpeg**][ffmpeg] inbuilt encoders to encode lossless multimedia files. This mode provides us the ability to exploit almost any parameter available within FFmpeg, effortlessly and flexibly, and while doing that it robustly handles all errors/warnings quietly. **You can find more about this mode [here ➶][cm-writegear-doc]**



- **Non-Compression Mode:** In this mode, WriteGear utilizes basic [**OpenCV's inbuilt VideoWriter API**][opencv-vw] tools. This mode also supports all parameter transformations available within OpenCV's VideoWriter API, but it lacks the ability to manipulate encoding parameters and other important features like video compression, audio encoding, etc. **You can learn about this mode [here ➶][ncm-writegear-doc]**



### WriteGear API Guide:



[**>>> Usage Guide**][writegear-doc]



 



 



## StreamGear





  NetGear API




> _StreamGear automates transcoding workflow for generating Ultra-Low Latency, High-Quality, Dynamic & Adaptive Streaming Formats (such as MPEG-DASH and Apple HLS) in just few lines of python code._



StreamGear provides a standalone, highly extensible, and flexible wrapper around [**FFmpeg**][ffmpeg] multimedia framework for generating chunked-encoded media segments of the content.



SteamGear is an out-of-the-box solution for transcoding source videos/audio files & real-time video frames and breaking them into a sequence of multiple smaller chunks/segments of suitable lengths. These segments make it possible to stream videos at different quality levels _(different bitrates or spatial resolutions)_ and can be switched in the middle of a video from one quality level to another – if bandwidth permits – on a per-segment basis. A user can serve these segments on a web server that makes it easier to download them through HTTP standard-compliant GET requests.



SteamGear currently supports [**MPEG-DASH**](https://www.encoding.com/mpeg-dash/) _(Dynamic Adaptive Streaming over HTTP, ISO/IEC 23009-1)_ and [**Apple HLS**](https://developer.apple.com/documentation/http_live_streaming) _(HTTP Live Streaming)_. But, Multiple DRM support is yet to be implemented.



SteamGear also creates a Manifest file _(such as MPD in-case of DASH)_ or a Master Playlist _(such as M3U8 in-case of Apple HLS)_ besides segments that describe these segment information _(timing, URL, media characteristics like video resolution and bit rates)_ and is provided to the client before the streaming session.



**StreamGear primarily works in two Independent Modes for transcoding which serves different purposes:**



- **Single-Source Mode:** In this mode, StreamGear **transcodes entire video file** _(as opposed to frame-by-frame)_ into a sequence of multiple smaller chunks/segments for streaming. This mode works exceptionally well when you're transcoding long-duration lossless videos(with audio) for streaming that required no interruptions. But on the downside, the provided source cannot be flexibly manipulated or transformed before sending onto FFmpeg Pipeline for processing. **_Learn more about this mode [here ➶][ss-mode-doc]_**



- **Real-time Frames Mode:** In this mode, StreamGear directly **transcodes frame-by-frame** _(as opposed to a entire video file)_, into a sequence of multiple smaller chunks/segments for streaming. This mode works exceptionally well when you desire to flexibility manipulate or transform [`numpy.ndarray`](https://numpy.org/doc/1.18/reference/generated/numpy.ndarray.html#numpy-ndarray) frames in real-time before sending them onto FFmpeg Pipeline for processing. But on the downside, audio has to added manually _(as separate source)_ for streams. **_Learn more about this mode [here ➶][rtf-mode-doc]_**



### StreamGear API Guide:



[**>>> Usage Guide**][streamgear-doc]



 



 



## NetGear





  NetGear API




> _NetGear is exclusively designed to transfer video-frames & data synchronously between interconnecting systems over the network in real-time._



NetGear implements a high-level wrapper around [**PyZmQ**][pyzmq] python library that contains python bindings for [**ZeroMQ**][zmq] - a high-performance asynchronous distributed messaging library.



NetGear seamlessly supports additional [**bidirectional data transmission**][netgear_bidata_doc] between receiver(client) and sender(server) while transferring video-frames all in real-time.



NetGear can also robustly handle [**Multiple Server-Systems**][netgear_multi_server_doc] and [**Multiple Client-Systems**][netgear_multi_client_doc] and at once, thereby providing access to a seamless exchange of video-frames & data between multiple devices across the network at the same time.



NetGear allows remote connection over [**SSH Tunnel**][netgear_sshtunnel_doc] that allows us to connect NetGear client and server via secure SSH connection over the untrusted network and access its intranet services across firewalls.



NetGear also enables real-time [**JPEG Frame Compression**][netgear_compression_doc] capabilities for boosting performance significantly while sending video-frames over the network in real-time.



For security, NetGear implements easy access to ZeroMQ's powerful, smart & secure Security Layers that enable [**Strong encryption on data**][netgear_security_doc] and unbreakable authentication between the Server and the Client with the help of custom certificates.



**NetGear as of now seamlessly supports three ZeroMQ messaging patterns:**



- [**`zmq.PAIR`**][zmq-pair] _(ZMQ Pair Pattern)_

- [**`zmq.REQ/zmq.REP`**][zmq-req-rep] _(ZMQ Request/Reply Pattern)_

- [**`zmq.PUB/zmq.SUB`**][zmq-pub-sub] _(ZMQ Publish/Subscribe Pattern)_



Whereas supported protocol are: `tcp` and `ipc`.



### NetGear API Guide:



[**>>> Usage Guide**][netgear-doc]



 



 



## WebGear



> _WebGear is a powerful [ASGI](https://asgi.readthedocs.io/en/latest/) Video-Broadcaster API ideal for transmitting [Motion-JPEG](https://en.wikipedia.org/wiki/Motion_JPEG)-frames from a single source to multiple recipients via the browser._



WebGear API works on [**Starlette**](https://www.starlette.io/)'s ASGI application and provides a highly extensible and flexible async wrapper around its complete framework. WebGear can flexibly interact with Starlette's ecosystem of shared middleware, mountable applications, [Response classes](https://www.starlette.io/responses/), [Routing tables](https://www.starlette.io/routing/), [Static Files](https://www.starlette.io/staticfiles/), [Templating engine(with Jinja2)](https://www.starlette.io/templates/), etc.



WebGear API uses an intraframe-only compression scheme under the hood where the sequence of video-frames are first encoded as JPEG-DIB (JPEG with Device-Independent Bit compression) and then streamed over HTTP using Starlette's Multipart [Streaming Response](https://www.starlette.io/responses/#streamingresponse) and a [Uvicorn](https://www.uvicorn.org/#quickstart) ASGI Server. This method imposes lower processing and memory requirements, but the quality is not the best, since JPEG compression is not very efficient for motion video.



In layman's terms, WebGear acts as a powerful **Video Broadcaster** that transmits live video-frames to any web-browser in the network. Additionally, WebGear API also provides a special internal wrapper around [VideoGear](#videogear), which itself provides internal access to both [CamGear](#camgear) and [PiGear](#pigear) APIs, thereby granting it exclusive power of broadcasting frames from any incoming stream. It also allows us to define our custom Server as source to transform frames easily before sending them across the network(see this [doc][webgear-cs] example).



**Below is a snapshot of a WebGear Video Server in action on Chrome browser:**





  WebGear in action!

  


  WebGear Video Server at http://localhost:8000/ address.




**Code to generate the above result:**



```python

# import required libraries

import uvicorn

from vidgear.gears.asyncio import WebGear



# various performance tweaks

options = {

    "frame_size_reduction": 40,

    "frame_jpeg_quality": 80,

    "frame_jpeg_optimize": True,

    "frame_jpeg_progressive": False,

}



# initialize WebGear app

web = WebGear(source="foo.mp4", logging=True, **options)



# run this app on Uvicorn server at address http://localhost:8000/

uvicorn.run(web(), host="localhost", port=8000)



# close app safely

web.shutdown()

```



### WebGear API Guide:



[**>>> Usage Guide**][webgear-doc]



 



 



## WebGear_RTC



> _WebGear_RTC is similar to [WeGear API](#webgear) in many aspects but utilizes [WebRTC][webrtc] technology under the hood instead of Motion JPEG, which makes it suitable for building powerful video-streaming solutions for all modern browsers as well as native clients available on all major platforms._



WebGear_RTC is implemented with the help of [**aiortc**][aiortc] library which is built on top of asynchronous I/O framework for Web Real-Time Communication (WebRTC) and Object Real-Time Communication (ORTC) and supports many features like SDP generation/parsing, Interactive Connectivity Establishment with half-trickle and mDNS support, DTLS key and certificate generation, DTLS handshake, etc.



WebGear_RTC can handle [multiple consumers][webgear_rtc-mc] seamlessly and provides native support for ICE _(Interactive Connectivity Establishment)_ protocol, STUN _(Session Traversal Utilities for NAT)_, and TURN _(Traversal Using Relays around NAT)_ servers that help us to seamlessly establish direct media connection with the remote peers for uninterrupted data flow. It also allows us to define our custom streaming class with suitable source to transform frames easily before sending them across the network(see this [doc][webgear_rtc-cs] example).



WebGear_RTC API works in conjunction with [**Starlette**][starlette]'s ASGI application and provides easy access to its complete framework. WebGear_RTC can also flexibly interact with Starlette's ecosystem of shared middleware, mountable applications, [Response classes](https://www.starlette.io/responses/), [Routing tables](https://www.starlette.io/routing/), [Static Files](https://www.starlette.io/staticfiles/), [Templating engine(with Jinja2)](https://www.starlette.io/templates/), etc.



Additionally, WebGear_RTC API also provides a special internal wrapper around [VideoGear](#videogear), which itself provides internal access to both [CamGear](#camgear) and [PiGear](#pigear) APIs.



**Below is a snapshot of a WebGear_RTC Media Server in action on Chrome browser:**





  WebGear_RTC in action!

  


  WebGear_RTC Video Server at http://localhost:8000/ address.




**Code to generate the above result:**



```python

# import required libraries

import uvicorn

from vidgear.gears.asyncio import WebGear_RTC



# various performance tweaks

options = {

    "frame_size_reduction": 30,

}



# initialize WebGear_RTC app

web = WebGear_RTC(source="foo.mp4", logging=True, **options)



# run this app on Uvicorn server at address http://localhost:8000/

uvicorn.run(web(), host="localhost", port=8000)



# close app safely

web.shutdown()

```



### WebGear_RTC API Guide:



[**>>> Usage Guide**][webgear_rtc-doc]



 



 



## NetGear_Async





  WebGear in action!



.



> _NetGear_Async can generate the same performance as [NetGear API](#netgear) at about one-third the memory consumption, and also provide complete server-client handling with various options to use variable protocols/patterns similar to NetGear, but lacks in term of flexibility as it supports only a few [NetGear's Exclusive Modes][netgear-exm]._



NetGear_Async is built on [`zmq.asyncio`][asyncio-zmq], and powered by a high-performance asyncio event loop called [**`uvloop`**][uvloop] to achieve unmatchable high-speed and lag-free video streaming over the network with minimal resource constraints. NetGear_Async can transfer thousands of frames in just a few seconds without causing any significant load on your system.



NetGear_Async provides complete server-client handling and options to use variable protocols/patterns similar to [NetGear API](#netgear). Furthermore, NetGear_Async allows us to define our custom Server as source to transform frames easily before sending them across the network(see this [doc][netgear_async-cs] example).



NetGear_Async now supports additional [**bidirectional data transmission**][btm_netgear_async] between receiver(client) and sender(server) while transferring video-frames. Users can easily build complex applications such as like [Real-Time Video Chat][rtvc] in just few lines of code.



NetGear_Async as of now supports all four ZeroMQ messaging patterns:



- [**`zmq.PAIR`**][zmq-pair] _(ZMQ Pair Pattern)_

- [**`zmq.REQ/zmq.REP`**][zmq-req-rep] _(ZMQ Request/Reply Pattern)_

- [**`zmq.PUB/zmq.SUB`**][zmq-pub-sub] _(ZMQ Publish/Subscribe Pattern)_

- [**`zmq.PUSH/zmq.PULL`**][zmq-pull-push] _(ZMQ Push/Pull Pattern)_



Whereas supported protocol are: `tcp` and `ipc`.



### NetGear_Async API Guide:



[**>>> Usage Guide**][netgear_async-doc]



 



 



# Contributions





   
👑 Contributor Hall of Fame 👑





   

    



  

  
We're happy to meet new contributors💗








We welcome your contributions to help us improve and extend this project. If you want to get involved with VidGear development, checkout the **[Contribution Guidelines ▶️][contribute]**



We're offering support for VidGear on [**Gitter Community Channel**](https://gitter.im/vidgear/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge). Come and join the conversation over there!



 



 



# Donations





   PiGear

   
VidGear is free and open source and will always remain so. ❤️





It is something I am doing with my own free time. But so much more needs to be done, and I need your help to do this. For just the price of a cup of coffee, you can make a difference 🙂



Buy Me a Coffee at ko-fi.com



 



 



# Citation



Here is a Bibtex entry you can use to cite this project in a publication:



[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8174694.svg)](https://doi.org/10.5281/zenodo.8174694)



```BibTeX

@software{vidgear,

  author       = {Abhishek Thakur and

                  Zoe Papakipos and

                  Christian Clauss and

                  Christian Hollinger and

                  Ian Max Andolina and

                  Vincent Boivin and

                  enarche-ahn and

                  freol35241 and

                  Benjamin Lowe and

                  Mickaël Schoentgen and

                  Renaud Bouckenooghe},

  title        = {abhiTronix/vidgear: VidGear v0.3.1},

  month        = jul,

  year         = 2023,

  publisher    = {Zenodo},

  version      = {vidgear-0.3.1},

  doi          = {10.5281/zenodo.8174694},

  url          = {https://doi.org/10.5281/zenodo.8174694}

}

```



 



 



# Copyright



**Copyright © abhiTronix 2019**



This library is released under the **[Apache 2.0 License][license]**.



[appveyor]: https://img.shields.io/appveyor/ci/abhitronix/vidgear.svg?style=for-the-badge&logo=appveyor

[codecov]: https://img.shields.io/codecov/c/github/abhiTronix/vidgear/testing?logo=codecov&style=for-the-badge

[github-cli]: https://img.shields.io/github/actions/workflow/status/abhiTronix/vidgear/.github/workflows/ci_linux.yml?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB3aWR0aD0iNDgiIGhlaWdodD0iNDgiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggY2xpcC1ydWxlPSJldmVub2RkIiBkPSJNMTAgMWE5IDkgMCAwMTkgOSA5IDkgMCAwMS05IDkgOSA5IDAgMDEtOS05IDkgOSAwIDAxOS05ek0yMyAxOWE2IDYgMCAxMTAgMTIgNiA2IDAgMDEwLTEyek0yMyAzNWE2IDYgMCAxMTAgMTIgNiA2IDAgMDEwLTEyeiIgc3Ryb2tlPSJ2YXIoLS1jb2xvci1tYXJrZXRpbmctaWNvbi1wcmltYXJ5LCAjMjA4OEZGKSIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz48cGF0aCBjbGlwLXJ1bGU9ImV2ZW5vZGQiIGQ9Ik00MSAzNWE2IDYgMCAxMTAgMTIgNiA2IDAgMDEwLTEyeiIgc3Ryb2tlPSJ2YXIoLS1jb2xvci1tYXJrZXRpbmctaWNvbi1zZWNvbmRhcnksICM3OUI4RkYpIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIvPjxwYXRoIGQ9Ik0yNS4wMzcgMjMuNjA3bC0zLjA3IDMuMDY1LTEuNDktMS40ODUiIHN0cm9rZT0idmFyKC0tY29sb3ItbWFya2V0aW5nLWljb24tcHJpbWFyeSwgIzIwODhGRikiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+PHBhdGggY2xpcC1ydWxlPSJldmVub2RkIiBkPSJNNDEgMTlhNiA2IDAgMTEwIDEyIDYgNiAwIDAxMC0xMnoiIHN0cm9rZT0idmFyKC0tY29sb3ItbWFya2V0aW5nLWljb24tcHJpbWFyeSwgIzIwODhGRikiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+PHBhdGggZD0iTTQzLjAzNiAyMy42MDdsLTMuMDY5IDMuMDY1LTEuNDktMS40ODVNNyA2LjgxMmExIDEgMCAwMTEuNTMzLS44NDZsNS4xMTMgMy4yMmExIDEgMCAwMS0uMDA2IDEuNjk3bC01LjExMyAzLjE3QTEgMSAwIDAxNyAxMy4yMDNWNi44MTN6TTkgMTl2MTVjMCAzLjg2NiAzLjE3NyA3IDcgN2gxIiBzdHJva2U9InZhcigtLWNvbG9yLW1hcmtldGluZy1pY29uLXByaW1hcnksICMyMDg4RkYpIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIvPjxwYXRoIGQ9Ik0xNi45NDkgMjZhMSAxIDAgMTAwLTJ2MnpNOCAxOS4wMzVBNi45NjUgNi45NjUgMCAwMDE0Ljk2NSAyNnYtMkE0Ljk2NSA0Ljk2NSAwIDAxMTAgMTkuMDM1SDh6TTE0Ljk2NSAyNmgxLjk4NHYtMmgtMS45ODR2MnoiIGZpbGw9InZhcigtLWNvbG9yLW1hcmtldGluZy1pY29uLXByaW1hcnksICMyMDg4RkYpIi8+PHBhdGggZD0iTTI5LjA1NSAyNWg1Ljk0NCIgc3Ryb2tlPSJ2YXIoLS1jb2xvci1tYXJrZXRpbmctaWNvbi1wcmltYXJ5LCAjMjA4OEZGKSIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz48cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTIxIDQwYTEgMSAwIDExLS4wMDEgMi4wMDFBMSAxIDAgMDEyMSA0MHpNMjUgNDBhMSAxIDAgMTEtLjAwMSAyLjAwMUExIDEgMCAwMTI1IDQweiIgZmlsbD0idmFyKC0tY29sb3ItbWFya2V0aW5nLWljb24tc2Vjb25kYXJ5LCAjNzlCOEZGKSIvPjxwYXRoIGQ9Ik0zNC4wMDUgNDEuMDA3bC0xLjAxMy4wMzMiIHN0cm9rZT0idmFyKC0tY29sb3ItbWFya2V0aW5nLWljb24tc2Vjb25kYXJ5LCAjNzlCOEZGKSIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiLz48L3N2Zz4=

[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAABC0lEQVRYhdWVPQoCMRCFX6HY2ghaiZUXsLW0EDyBrbWtN/EUHsHTWFnYyCL4gxibVZZlZzKTnWz0QZpk5r0vIdkF/kBPAMOKeddE+CQPKoc5Yt5cTjBMdQSwDQToWgBJAn3jmhqgltapAV6E6b5U17MGGAUaUj07TficMfIBZDV6vxowBm1BP9WbSQE4o5h9IjPJmy73TEPDDxVmoZdQrQ5jRhly9Q8tgMUXkIIWn0oG4GYQfAXQzz1PGoCiQndM7b4RgJay/h7zBLT3hASgoKjamQJMreKf0gfuAGyYtXEIAKcL/Dss15iq6ohXghozLYiAMxPuACwtIT4yeQUxAaLrZwAoqGRKGk7qDSYTfYQ8LuYnAAAAAElFTkSuQmCC

[twitter-badge]: https://img.shields.io/badge/Tweet-Now-blue.svg?style=for-the-badge&logo=twitter

[azure-badge]: https://img.shields.io/azure-devops/build/abhiuna12/942b3b13-d745-49e9-8d7d-b3918ff43ac2/2/testing?logo=azure-pipelines&style=for-the-badge

[pypi-badge]: https://img.shields.io/pypi/v/vidgear.svg?style=for-the-badge&logo=pypi

[gitter-bagde]: https://img.shields.io/badge/Chat-Gitter-blueviolet.svg?style=for-the-badge&logo=gitter

[coffee-badge]: https://abhitronix.github.io/img/vidgear/orange_img.png

[kofi-badge]: https://www.ko-fi.com/img/githubbutton_sm.svg

[black-badge]: https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge&logo=github



[release]: https://github.com/abhiTronix/vidgear/releases/latest

[pypi]: https://pypi.org/project/vidgear/

[gitter]: https://gitter.im/vidgear/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge

[twitter-intent]: https://twitter.com/intent/tweet?url=https%3A%2F%2Fabhitronix.github.io%2Fvidgear&via%20%40abhi_una12&text=Checkout%20VidGear%20-%20A%20High-Performance%20Video-Processing%20Python%20Framework.&hashtags=vidgear%20%23videoprocessing%20%23python%20%23threaded%20%23asyncio

[coffee]: https://www.buymeacoffee.com/2twOXFvlA

[kofi]: https://ko-fi.com/W7W8WTYO

[license]: https://github.com/abhiTronix/vidgear/blob/master/LICENSE

[github-flow]: https://github.com/abhiTronix/vidgear/actions?query=workflow%3A%22Run+Linux+CI-Tests+for+vidgear%22

[azure-pipeline]: https://dev.azure.com/abhiuna12/public/_build?definitionId=2

[app]: https://ci.appveyor.com/project/abhiTronix/vidgear

[code]: https://codecov.io/gh/abhiTronix/vidgear

[btm_netgear_async]: https://abhitronix.github.io/vidgear/latest/gears/netgear_async/advanced/bidirectional_mode/

[rtvc]: https://abhitronix.github.io/vidgear/latest/gears/netgear_async/advanced/bidirectional_mode/#using-bidirectional-mode-for-video-frames-transfer

[test-4k]: https://github.com/abhiTronix/vidgear/blob/e0843720202b0921d1c26e2ce5b11fadefbec892/vidgear/tests/benchmark_tests/test_benchmark_playback.py#L65

[bs_script_dataset]: https://github.com/abhiTronix/vidgear/blob/testing/scripts/bash/prepare_dataset.sh

[faq]: https://abhitronix.github.io/vidgear/latest/help/get_help/#frequently-asked-questions

[contribute]: https://abhitronix.github.io/vidgear/latest/contribution

[rtsp-ex]: https://abhitronix.github.io/vidgear/latest/help/writegear_ex/#using-writegears-compression-mode-for-rtsprtp-live-streaming

[doc-vidgear-purpose]: https://abhitronix.github.io/vidgear/latest/help/motivation/#why-is-vidgear-a-thing

[live-stream]: https://abhitronix.github.io/vidgear/latest/gears/writegear/compression/usage/#using-compression-mode-for-live-streaming

[live-audio-doc]: https://abhitronix.github.io/vidgear/latest/gears/writegear/compression/usage/#using-compression-mode-with-live-audio-input

[piping-live-videos]: https://abhitronix.github.io/vidgear/latest/gears/camgear/usage/#using-camgear-with-streaming-websites

[ffmpeg-doc]: https://abhitronix.github.io/vidgear/latest/gears/writegear/compression/advanced/ffmpeg_install/

[youtube-doc]: https://abhitronix.github.io/vidgear/latest/gears/camgear/usage/#using-camgear-with-youtube-videos

[tqm-doc]: https://abhitronix.github.io/vidgear/latest/bonus/TQM/#threaded-queue-mode

[camgear-doc]: https://abhitronix.github.io/vidgear/latest/gears/camgear/overview/

[stabilizer-doc]: https://abhitronix.github.io/vidgear/latest/gears/stabilizer/overview/

[stabilizer-doc-ex]: https://abhitronix.github.io/vidgear/latest/gears/videogear/usage/#using-videogear-with-video-stabilizer-backend

[videogear-doc]: https://abhitronix.github.io/vidgear/latest/gears/videogear/overview/

[pigear-doc]: https://abhitronix.github.io/vidgear/latest/gears/pigear/overview/

[cm-writegear-doc]: https://abhitronix.github.io/vidgear/latest/gears/writegear/compression/overview/

[ncm-writegear-doc]: https://abhitronix.github.io/vidgear/latest/gears/writegear/non_compression/overview/

[screengear-doc]: https://abhitronix.github.io/vidgear/latest/gears/screengear/overview/

[streamgear-doc]: https://abhitronix.github.io/vidgear/latest/gears/streamgear/introduction/

[writegear-doc]: https://abhitronix.github.io/vidgear/latest/gears/writegear/introduction/

[netgear-doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/overview/

[webgear-doc]: https://abhitronix.github.io/vidgear/latest/gears/webgear/overview/

[webgear_rtc-doc]: https://abhitronix.github.io/vidgear/latest/gears/webgear_rtc/overview/

[netgear_async-doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear_async/overview/

[drop35]: https://github.com/abhiTronix/vidgear/issues/99

[custom-command-doc]: https://abhitronix.github.io/vidgear/latest/gears/writegear/compression/advanced/cciw/

[advanced-webgear-doc]: https://abhitronix.github.io/vidgear/latest/gears/webgear/advanced/

[netgear_bidata_doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/advanced/bidirectional_mode/

[netgear_compression_doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/advanced/compression/

[netgear_security_doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/advanced/secure_mode/

[netgear_multi_server_doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/advanced/multi_server/

[netgear_multi_client_doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/advanced/multi_client/

[netgear_sshtunnel_doc]: https://abhitronix.github.io/vidgear/latest/gears/netgear/advanced/ssh_tunnel/

[netgear-exm]: https://abhitronix.github.io/vidgear/latest/gears/netgear/overview/#modes-of-operation

[stabilize_webgear_doc]: https://abhitronix.github.io/vidgear/latest/gears/webgear/advanced/#using-webgear-with-real-time-video-stabilization-enabled

[netgear_async-cs]: https://abhitronix.github.io/vidgear/latest/gears/netgear_async/usage/#using-netgear_async-with-a-custom-sourceopencv

[installation]: https://abhitronix.github.io/vidgear/latest/installation/

[gears]: https://abhitronix.github.io/vidgear/latest/gears

[switch_from_cv]: https://abhitronix.github.io/vidgear/latest/switch_from_cv/

[ss-mode-doc]: https://abhitronix.github.io/vidgear/latest/gears/streamgear/ssm/#overview

[rtf-mode-doc]: https://abhitronix.github.io/vidgear/latest/gears/streamgear/rtfm/#overview

[webgear-cs]: https://abhitronix.github.io/vidgear/latest/gears/webgear/advanced/#using-webgear-with-a-custom-sourceopencv

[webgear_rtc-cs]: https://abhitronix.github.io/vidgear/latest/gears/webgear_rtc/advanced/#using-webgear_rtc-with-a-custom-sourceopencv

[webgear_rtc-mc]: https://abhitronix.github.io/vidgear/latest/gears/webgear_rtc/advanced/#using-webgear_rtc-as-real-time-broadcaster

[docs]: https://abhitronix.github.io/vidgear



[asyncio-zmq]: https://pyzmq.readthedocs.io/en/latest/api/zmq.asyncio.html

[uvloop]: https://github.com/MagicStack/uvloop

[streamlink]: https://streamlink.github.io/

[aiortc]: https://aiortc.readthedocs.io/en/latest/

[pyscreenshot]: https://github.com/ponty/pyscreenshot

[uvloop-ns]: https://github.com/MagicStack/uvloop/issues/14

[ffmpeg]: https://www.ffmpeg.org/

[flake8]: https://flake8.pycqa.org/en/latest/

[dxcam]: https://github.com/ra1nty/DXcam

[black]: https://github.com/psf/black

[pytest]: https://docs.pytest.org/en/latest/

[opencv-writer]: https://docs.opencv.org/master/dd/d9e/classcv_1_1VideoWriter.html#ad59c61d8881ba2b2da22cff5487465b5

[opencv-windows]: https://www.learnopencv.com/install-opencv3-on-windows/

[opencv-linux]: https://www.pyimagesearch.com/2018/05/28/ubuntu-18-04-how-to-install-opencv/

[opencv-pi]: https://www.pyimagesearch.com/2018/09/26/install-opencv-4-on-your-raspberry-pi/

[starlette]: https://www.starlette.io/

[uvicorn]: http://www.uvicorn.org/

[daphne]: https://github.com/django/daphne/

[hypercorn]: https://pgjones.gitlab.io/hypercorn/

[prs]: http://makeapullrequest.com

[opencv]: https://github.com/opencv/opencv

[picamera]: https://github.com/waveform80/picamera

[pafy]: https://github.com/mps-youtube/pafy

[pyzmq]: https://github.com/zeromq/pyzmq

[zmq]: https://zeromq.org/

[mss]: https://github.com/BoboTiG/python-mss

[pip]: https://pip.pypa.io/en/stable/installing/

[opencv-vc]: https://docs.opencv.org/master/d8/dfe/classcv_1_1VideoCapture.html#a57c0e81e83e60f36c83027dc2a188e80

[ov5647-picam]: https://github.com/techyian/MMALSharp/doc/OmniVision-OV5647-Camera-Module

[imx219-picam]: https://github.com/techyian/MMALSharp/doc/Sony-IMX219-Camera-Module

[opencv-vw]: https://docs.opencv.org/3.4/d8/dfe/classcv_1_1VideoCapture.html

[yt_dlp]: https://github.com/yt-dlp/yt-dlp

[numpy]: https://github.com/numpy/numpy

[zmq-pair]: https://learning-0mq-with-pyzmq.readthedocs.io/en/latest/pyzmq/patterns/pair.html

[zmq-req-rep]: https://learning-0mq-with-pyzmq.readthedocs.io/en/latest/pyzmq/patterns/client_server.html

[zmq-pub-sub]: https://learning-0mq-with-pyzmq.readthedocs.io/en/latest/pyzmq/patterns/pubsub.html

[zmq-pull-push]: https://learning-0mq-with-pyzmq.readthedocs.io/en/latest/pyzmq/patterns/pushpull.html#push-pull

[picamera-setting]: https://picamera.readthedocs.io/en/release-1.13/quickstart.html

[webrtc]: https://webrtc.org/