vidgear

vidgear - VidGear Stable v0.3.3 Latest Release

Published by abhiTronix 4 months ago

This update significantly enhances Vidgear's capabilities, ensuring better performance, broader compatibility, and improved user experience. The introduction of the Picamera2 API support, enhanced error handling, and detailed documentation updates are pivotal in making Vidgear more robust and user-friendly.

📓 Complete Release Notes can be found here ↗️

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 🙂

What's Changed

New Features ✨

PiGear:
- Official Support for Picamera2 API backend:
  - This massive update brings official support for the new Picamera2 API, unlocking powerful features for Raspberry Pi Camera Modules and limited USB camera support.
  - Seamless Python wrapper: A robust wrapper around Picamera2 API library simplifies integration with minimal code changes for existing PiGear users.
  - Enhanced camera control: Leverages libcamera API under the hood for Raspberry Pi Camera Modules.
  - Existing compatibility: Maintains compatibility with PiGear's existing super-charged multi-threaded and colorspace manipulation framework.
  - Proper Resource management: Ensures proper resource release during PiGear termination.
  - USB camera support (limited): Provides basic functionality for USB webcams. PiGear could accurately differentiates between USB and Raspberry Pi cameras using metadata.
  - Backward compatibility: Seamlessly switches to the legacy Picamera library backend if Picamera2 is unavailable.
  - Standalone functionalities: Standalone functionalities for both legacy picamera and newer picamera2 backends for clarity.
  - Advanced optional parameters handling: Handles camera configurational parameters and user-defined settings for various camera types.
StreamGear:
- Introduced new -enable_force_termination attribute for immediate FFmpeg process termination.
Helper:
- Added support for SRTP/RTSPS in is_valid_url function:
  - SRTP/RTSPS extends RTSP/RTP to encrypt video and audio data using the same ciphers as HTTPS, typically AES with a 128-bit key length.
- Added a custom deprecated decorator to mark deprecated functions and parameters.

Updates/Improvements ⚡️

Core:
- Improved exception handling for module imports.
- Improved colorspace handling in videocapture gears.
Asyncio:
- Replaced deprecated Starlette's on_shutdown parameter with an async context manager lifespan in WebGear and WebGear_RTC APIs.
NetGear_Async API:
- Changed launch method to use self.loop.create_task() instead of asyncio.ensure_future()
- Moved the event loop initialization code to an earlier point before setting event loop policy to ensure it is set up correctly before selecting WindowsSelectorEventLoop policy.
StreamGear:
- Updated close() methods for handling gracefully signal interruptions based on different operating systems with device audio streams.
- Enhanced stream copy support in Single Source mode.
NetGear:
- Handled socket session expiration more gracefully in recv_handler.
- Ensured proper termination of the ZMQ context and socket when closing the NetGear instance.
WebGear:
- Enhanced error messages for WebGear auto-generation workflow.
WriteGear:
- Improved error handling in execute_ffmpeg_cmd method.
Setup.py:
- Dropped legacy picamera dependency in setup.py.
- Updated pyzmq version to address installation issues.
Helper:
- Updated extract_time helper function regex to handle milliseconds.

Breaking Updates/Changes 💥

StreamGear:
- 💣 Deprecated terminate() method and introduce close() method.
  - The terminate() method in StreamGear is now deprecated and will be removed in a future release. Developers should use the new close() method instead, which provides a more descriptive name like in WriteGear API for terminating StreamGear processes safely.
- 💣 Deprecated rgb_mode parameter in stream() method.
  - This parameter will be removed in a future version, and only BGR format frames will be supported.
- 💣 Restricted -livestream parameter to Real-time Frames Mode only.
  - Live streaming is intended for low-latency streaming of real-time frames, where chunks contain only the most recent frames. It doesn't make sense when streaming from a video file, as the entire file can be streamed normally without the need for live streaming.

Bug-fixes 🐛

PiGear:
- Modify PiGear class behavior when enforce_legacy_picamera=True on unsupported system.
StreamGear:
- Removed non-essential aspect ratio parameter to prevent unwanted distortions.
NetGear:
- Fixed Secure Mode failing to work on conflicting ZMQ Contexts.
- Fixed msg_json undefined when terminating context in the recv_handler method.
CamGear:
- Fixed logging condition for yt-dlp.

vidgear - VidGear Stable v0.3.2

Published by abhiTronix about 1 year ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

NetGear:
- Added new kill parameter to close() method to forcefully kill ZMQ context instead of graceful exit only in the receive mode.
- Added new subscriber_timeout integer optional parameter to support timeout with pattern=2 (or Publisher-Subscriber) pattern.
  - Receiver will exit safely if timeout defined(any value(in milliseconds) > 0), and timeout occurs in Receiver Mode with pattern=2.
  - 💬 Note: Default behavior still is to block the thread till infinite time.
WriteGear:
- Added new -disable_ffmpeg_window optional Boolean flag to enable patch that prevents FFmpeg creation window from opening when building .exe files on Windows OS. (PR by @ibtsam3301)
  - 💬 Note: -disable_ffmpeg_window optional Boolean flag is only available on Windows OS with logging disabled(logging=False) in compression mode.
  - 💬 Use Case: This flag can be useful while creating an .exe file for a python script that uses WriteGear API. On windows even after creating the .exe file in windowed mode or no-console mode, the ffmpeg.exe command line window would pop up while its being used by WriteGear API.
Setup.py
- Added official support for python 3.11.x legacies.

Updates/Improvements ⚡️

Asyncio:
- Formatted TemplateResponse class parameters w.r.t new changes in backend Starlette API.
Setup.py:
- Readded latest patch to uvicorn, starlette, pyzmq dependencies.
- Removed 3.7 legacy from Programming Language metadata.
Maintenance:
- Added GitHub sponsors and dropped liberapay from Funding.yml.
Docs:
- Updated information related to Supported Dimensional Attributes in ScreenGear docs.
- Updated minimum python to version 3.8 while installing vidgear in docs.
- Updated API-specific dependencies in docs.

Breaking Updates/Changes 💥

Setup.py:
- 💣 Removed support for python-3.7 legacies
  - 💬 Raised python_requires to >=3.8. Thereby python 3.7 and any before legacy are no longer supported.

Bug-fixes 🐛

ScreenGear:
- Fixed swapped region dimensions bug with dxcam backend.
- Fixed "mss" backend disabled when monitor parameter is not defined.
Docs:
- Fixed missing compression_mode flags in WriteGear API docs.

vidgear - VidGear Stable v0.3.1

Published by abhiTronix about 1 year ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

WebGear:
- Added an option to add a custom video endpoint path.
  - Users can now change the video endpoint path from "/video" to any alphanumeric string.
  - Added the custom_video_endpoint optional string attribute for this purpose.
  - Only alphanumeric strings with no spaces in between are allowed as its value.
ScreenGear:
- Added dxcam backend support for Windows machines.
  - dxcam is now the default backend for Windows machines when no backend is defined.
  - Added support for variable screen dimensions to capture an area from the screen.
  - Added the optional flag dxcam_target_fps to control the target fps in dxcam. Defaults to 0 (disabled).
- Added support for tuple values in the monitor parameter to specify device and output indexes as (int[device_idx], int[output_idx]) in the dxcam backend only.
  - Default int index is also allowed as a value for selecting device index.
Helper
- Added multiple servers support for downloading assets.
  - Added GitHub server to the generate_webdata method to make it more robust for rate limits and other shortcomings.
  - Now, the generate_webdata method will retry a different server when one fails.
Setup.py
- Added dxcam dependency in core and asyncio extra requires for Windows machines.

Updates/Improvements ⚡️

WebGear:
- Improved the conditions logic to check if non-empty values are assigned to optional parameters.
WebGear_RTC:
- Improved the handling of the format parameter when constructing a VideoFrame from ndarray frames.
ScreenGear:
- Enforced dxcam backend (if installed) when monitor is defined on Windows machines.
- Refactored code blocks to ensure backward compatibility.

Breaking Updates/Changes 💥

ScreenGear:
- 💣 Previously enforced threaded queue mode is now completely removed, resulting in a potential performance boost.
  + 💬 Reason: The IO is automatically blocked by the screen refresh rate, so adding the overhead of maintaining a separate queue is pointless.
- 💣 Removed the THREAD_TIMEOUT optional flag.

Bug-fixes 🐛

WebGear_RTC:
- Fixed a bug caused by PyAV's error when ndim==3 grayscale frames are encountered.
  - The API will now drop the third dimension if ndim==3 grayscale frames are detected.
Setup.py:
- Starting from version 8.0.0, the python-mss library dropped support for Python 3.7, so as a temporary measure, mss dependency has been pinned to version 7.0.1.

vidgear - VidGear Stable v0.3.0

Published by abhiTronix over 1 year ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

WriteGear:
- Added support for higher than 8-bit depth frames with datatypes of unsigned integer(uint) kind and element size 2.
- Added new -input_pixfmt attribute to output_params dictionary parameter for easily specifying custom input pixel-format.
- Added support for Context Managers __enter__() and __exit__() methods for proper handling of resources via with statement for allocating and releasing resources precisely. (Suggested by @sueskind)
StreamGear:
- Added support for Context Managers __enter__() and __exit__() methods for proper handling of resources via with statement for allocating and releasing resources precisely. (Suggested by @sueskind)
WebGear:
- Added new skip_generate_webdata boolean optional attribute(False by default) to completely disable Data-Files Auto-Generation WorkFlow.
  - This flag enables only /video route for disabled Data-Files Auto-Generation WorkFlow.
Helper:
- Added more robust implementation of validate_audio method with more robust regex pattern for extracting audio-samplerate.
- Added support for Linux video device path (such as /dev/video0).
Maintenance:
- Logging current vidgear version when vidgear APIs are called, not at import.
  - Current version can only be logged by VidGear APIs with the logging turned on (i.e. logging=True).

Updates/Improvements ⚡️

WriteGear:
- Updated comments, description, and logging messages to more sensible and developer friendly.
  - Renamed startFFmpeg_Process internal class method to start_FFProcess.
  - Renamed Preprocess internal class method to PreprocessFFParams.
  - Renamed startCV_Process internal class method to start_CVProcess.
  - Renamed initiate internal class parameter to initiate_process.
  - Renamed force_termination internal class parameter to forced_termination.
Helper:
- Updated validate_audio method with improved and more robust regex patterns for identifying audio bitrate in ay audio file.
Setup.py:
- Replaced distutils.version.LooseVersion with pkg_resources.parse_version.
Maintenance:
- Replaced depreciated LooseVersion with parse_version.
- Updated Retry package to be imported from requests.adapters.
Bash Scripts:
- Updated FFmpeg Static Binaries links to latest date/version tag to 12-07-2022.

Breaking Updates/Changes 💥

WriteGear:
- 💣 Renamed output_filename string parameter to output.
- 💣 Renamed cmd parameter in execute_ffmpeg_cmd() class method to more sensible command.
- 💣 ValueError will be raised if datatype of input frames mismatches.

Bug-fixes 🐛

Camgear:
- Fixed CamGear.read() blocked unnecessarily.
- Fixed deadlock on termination.
ScreenGear:
- Fixed ScreenGear.read() blocked during startup.
  - 💬 During startup, ScreenGear.read() doesn't checks if queue is empty before continuing.
WriteGear:
- Fixed gstpipeline_mode not activating when wrongly assuming output value as valid path.
- Fixed name 'compression' is not defined bug.
Helper:
- Fixed fltp keyword in regex pattern causing non-ftlp streams to be not recognized.
- Fixed response.headers returning content-length as Nonetype since it may not necessarily have the Content-Length header set.
Setup:
- Pinned pyzmq==24.0.1 working version.

vidgear - VidGear Stable v0.2.6

Published by abhiTronix over 2 years ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

Docs:
- Added new bonus example for RSTP/RTP Live-Streaming using WriteGear's Compression Mode.
- Added "How to resolve zmq.error.ZMQError" FAQ for NetGear API.(PR by @iandol)
Maintenance:
- Added new patterns to .gitignore to ignore pypi's build directory and egg-info files.
CI:
- Switched to new Issue GitHub's form schema using YAMLs.

Updates/Improvements ⚡️

Setup.py:
- Replaced distutils.version.LooseVersion with pkg_resources.parse_version.
Docs:
- Updated Site Navigation.
  - Added new notices to inform users more effectively about bonus examples.
  - Added new Bonus section to navigation and moved suitable pages under it.
- Redesigned and Rewritten Donation and Contribution section to README.md.
API:
- Updated depreciated tostring() to tobytes() for the purposes for clarity in Python 3.2.
CI:
- Added more paths and files to skip commits.

Breaking Updates/Changes 💥

-input_framerate parameter now accepts any positive value for WriteGear and StreamGear APIs.

Bug-fixes 🐛

API: Fixed -input_framerate less than 5 does not get used in WriteGear and StreamGear APIs.(PR by @freol35241)
CamGear: Fixed Yt-dlp generated HTTP DASH Segments URLs not supported by OpenCV's VideoCapture(PR by @DynamiteC)
StreamGear:
- Fixed hls_segment_type not working bug. (PR by @enarche-ahn)
- Fixed critical logging parameter bug
  - Fixed debug logs even when logging=False in StreamGear's Real-time Mode. (patch suggested by @enarche-ahn)
  - Added length check to -video_source attribute to correctly infers it as empty(or invalid).
CI:
- Fixed pinned version syntax bug in docs_deployer workflow.
- Fixed typos in Github forms and its context.
Docs:
- Fixed jinja2 3.1.0 or above breaks mkdocs.
  - jinja2>=3.1.0 breaks mkdocs (mkdocs/mkdocs#2799), therefore pinned jinja2 version to <3.1.0.
- Fixed support for new mkdocstring versions
- Fixed Netgear+Webgear bonus example code bugs.(PR by @iandol)
- Fixed external bug that causing "Home" tab not responsive randomly when accessed from other tabs.

vidgear - VidGear Stable v0.2.5

Published by abhiTronix over 2 years ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

WriteGear:
- Added support for GStreamer pipeline in WriteGear API's Non-Compression mode:
  - Implemented GStreamer Pipeline Mode to accept GStreamer pipeline formatted as string to its output_filename parameter.
  - Added new special -gst_pipeline_mode attribute to its output_params dictionary parameter to enable this mode.
  - This feature provides flexible way to directly write video frames into custom GStreamer Pipeline with controlled bitrate.
- Added new -ffpreheaders special attribute to WriteGear's output_params dictionary parameter in Compression mode:
  - This attribute is specifically required to set special FFmpeg parameters in Compression Mode that are present at the starting of command(such as -re).
  - This attribute only accepts list datatype as value.
NetGear:
- Added bidirectional data transfer support to existing exclusive Multi-Clients and Multi-Servers exclusive modes:
  - Users will now able to send data bidirectionally in both Multi-Clients and Multi-Servers exclusive modes.
  - Bidirectional mode will no longer disables automatically when enabled along with Multi-Clients and Multi-Servers exclusive modes.
Maintenance:
- 🌟 Added official support for Python-3.10 legacies. 🌟
- Added float value support to THREAD_TIMEOUT optional attributes in threaded gears.

Updates/Improvements ⚡️

Setup.py:
- Dropped support for Python-3.6 and below legacies.
- Updated logging formating.
- Updated python_requires to >=3.7.
Helper:
- Vidgear will now report current version on every run.

Breaking Updates/Changes 💥

⚠️ Dropped support for Python-3.6 legacies from vidgear.

Bug-fixes 🐛

NetGear: Fixed bidirectional mode forcefully overriding multi-clients mode's payload.
Setup: Fixed uvicorn and aiortc dropped support for Python-3.6 legacies.

vidgear - VidGear Stable v0.2.4

Published by abhiTronix almost 3 years ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

CamGear:
- Added a new YT_backend Internal Class with YT-DLP backend:
  - Implemented YT_backend a new CamGear's Internal YT-DLP backend class for extracting metadata from Streaming URLs.
  - Added support for pipeling (live) video-frames from all yt-dlp supported streaming sites: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md#supported-sites
  - Implemented algorithm from scratch for auto-extracting resolution specific streamable URLs for pipelineing.
  - Added new ytv_metadata global parameter to CamGear for accessing video's metadata(such as duration, title, description) on-the-go.
  - ⚠️ Playlists are still unsupported.
WebGear_RTC:
- Implemented a new easy way of defining Custom Streaming Class with suitable source(such as OpenCV):
  - Added new custom_stream attribute with WebGear_RTC options parameter that allows you to easily define your own Custom Streaming Class with suitable source(such as OpenCV).
  - This implementation supports repeated Auto-Reconnection or Auto-Refresh out-of-the-box.
  - This implementation is more user-friendly and easy to integrate within complex APIs.
  - This implementation supports all vidgear's VideoCapture APIs readily as input.

Updates/Improvements ⚡️

CamGear:
- Added is_livestream global YT_backend parameters.
- Added default options for yt-dlp for extracting info_dict(metadata) of the video as a single JSON line.
- Removed all dead code related to streamlink backend.
Setup.py:
- Moved all API specific dependencies to extra_requires under the name "core". [PR #268 by @zpapakipos]
- Added rule to replace GitHub heading links in description.
- Updated extra_require dependencies.
- Removed streamlink dependency.
- Removed pafy dependency.

Breaking Updates/Changes 💥

⚠️ Installation command with pip has been changed in v0.2.4:
- The legacy pip install vidgear command now installs critical bare-minimum dependencies only. Therefore in order to automatically install all the API specific dependencies as previous versions, use pip install vidgear[core] command instead.
CamGear:
- ⚠️ Removed streamlink backend support from stream_mode in favor of more reliable CamGear's Internal YT-DLP backend class for extracting metadata from Streaming URLs.
  - CamGear will raise ValueError if streaming site URL is unsupported by yt-dlp backend.
  - CamGear will raise ValueError if yt-dlp isn't installed and stream_mode is enabled.
- ⚠️ Removed automatic enforcing of GStreamer backend for YouTube-livestreams and made it optional.
  - The CamGear will not raise ValueError if GStreamer support is missing in OpenCV backends.
WebGear_RTC:
- ⚠️ Removed support for assigning Custom Media Server Class(inherited from aiortc's VideoStreamTrack) in WebGear_RTC through its config global parameter.
- ⚠️ WebGear_RTC API will now throws ValueError if source parameter is NoneType as well as custom_stream attribute is undefined.
Helper:
- ⚠️ Removed restore_levelnames method.
- ⚠️ Removed youtube_url_validator method.

Bug-fixes 🐛

CamGear:
- Fixed KeyError Bug for missing attributed in meta_data json in some streaming sites.
Helper:
- Removed unused imports.

Related Pull Requests 🔧

PR #268
PR #272
PR #274

vidgear - VidGear Stable v0.2.3

Published by abhiTronix almost 3 years ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

CamGear:
- Added support for 4K Streaming URLs.
Helper:
- Implemented logging ColorFormatter string alignment.

Updates/Improvements ⚡️

CamGear:
- Replaced youtube-dl with yt-dlp as pafy backend for YouTube videos pipelining.
  - Implemented hack to trick pafy into assuming yt-dlp as youtube-dl.
  - Replaced youtube-dl dependency with yt-dlp.
  - Replaced youtube-dl imports with yt-dlp.
Helper:
- Enabled logging for check_WriteAccess method.
Maintenance:
- Added .gitignore for specifying intentionally untracked files to ignore
- Added .gitattributes to manage how Git reads line endings.
- Introduced python short-circuiting for handling logging logic in APIs.

Breaking Updates/Changes 💥

check_WriteAccess will now return as invalid path if writing directory does not exists. This will effect output file handling in WriteGear and StreamGear APIs.

Bug-fixes 🐛

StreamGear:
- Fixed StreamGear Malformed URI Error with HLS Segments [PR #243 by @Vboivin]
  - Removed the extra '%' character from the naming convention for segment files.
  - Used internal stream_count dict variable to alter template for HLS segment filenames.
WriteGear:
- Fixed bug in -disable_force_termination attribute logic which accidentally disables force termination.
WebGear_RTC:
- Fixed name 'VideoStreamTrack' is not defined bug.
Setup.py:
- Fixed TypeError bug.
- Fixed invalid latest_version retrieval.
Helper:
- Fixed check_WriteAccess failing to recognize correct permission for writing the output file on windows platform.
  - Implemented separate logic for Windows and *nix platforms.
- Fixed bug in check_WriteAccess that throws OSError while handling URLs.

Related Pull Requests 🔧

PR #249
PR #262

vidgear - VidGear Stable v0.2.2

Published by abhiTronix about 3 years ago

📓 Complete Release Notes can be found here ↗️

New Features ✨

StreamGear:
- Added native support for new Apple HLS (HTTP Live Streaming) HTTP streaming format in StreamGear.
- Added seamless support for audio input from external audio devices.
NetGear:
- New SSH Tunneling Mode for remote connection of ZMQ sockets across machines via SSH tunneling.
- Additional colorspace support for input frames with Frame-Compression enabled.
  - Allowed users to manually select colorspace on-the-fly with its JPEG frame compression mode.
NetGear_Async:
- New exclusive Bidirectional Mode for bidirectional data transfer with pure asyncio implementation.
  - ⚠️ Bidirectional mode is only available with User-defined Custom Source(i.e. source=None)
  - ⚠️ NetGear_Async will throw RuntimeError if bidirectional mode is disabled at server or client but not both.
- Added new disable_confirmation used to force disable termination confirmation from client in terminate_connection.
- Added task_done() method after every get() call to gracefully terminate queues.
- Added new secrets and string imports.
WebGear:
- Updated JPEG Frame compression with simplejpeg:
  - Implemented JPEG compression algorithm for 4-5% performance boost at cost of minor loss in quality.
  - Utilized encode_jpeg and decode_jpeg methods to implement turbo-JPEG transcoding with simplejpeg.
  - Added new options to control JPEG frames quality, enable fastest dct, fast upsampling to boost performance.
  - Added new jpeg_compression, jpeg_compression_quality, jpeg_compression_fastdct, jpeg_compression_fastupsample attributes.
- Added new WebGear Theme: (Checkout at https://github.com/abhiTronix/vidgear-vitals)
  - Added responsive image scaling according to screen aspect ratios.
  - Added responsive text scaling.
WebGear_RTC:
- Added native support for middlewares:
  - Added new global middleware variable for easily defining Middlewares as list.
- Added new WebGear_RTC Theme: (Checkout at https://github.com/abhiTronix/vidgear-vitals)
  - Implemented new responsive video scaling according to screen aspect ratios.
  - Added bootstrap CSS properties to implement auto-scaling.
Helper:
- New automated interpolation selection for gears:
  - Implemented retrieve_best_interpolation method to automatically select best available interpolation within OpenCV.
- Implemented get_supported_demuxers method to get list of supported demuxers.
Setup.py:
- Added new cython and msgpack dependency.
- Added msgpack and msgpack_numpy to auto-install latest.

Updates/Improvements ⚡️

VidGear Core:
- New behavior to virtually isolate optional API specific dependencies by silencing ImportError on all VidGear's APIs import.
- Implemented algorithm to cache all imports on startup but silence any ImportError on missing optional dependency.
- ⚠️ Now ImportError will be raised only any certain API specific dependency is missing during given API's initialization.
StreamGear:
- Replaced depreciated -min_seg_duration flag with -seg_duration.
- Removed redundant -re flag from RTFM.
- Improved Live-Streaming performance by disabling SegmentTimline
- Improved DASH assets detection for removal by using filename prefixes.
NetGear:
- Replaced np.newaxis with np.expand_dims.
- Replaced random module with secrets while generating system ID.
- Update array indexing with np.copy.
NetGear_Async:
- Improved custom source handling.
- Removed deprecated loop parameter from asyncio methods.
- Re-implemented skip_loop parameter in close() method.
- ⚠️ run_until_complete will not used if skip_loop is enabled.
- ⚠️ skip_loop now will create asyncio task instead and will enable disable_confirmation by default.
- Replaced create_task with ensure_future to ensure backward compatibility with python-3.6 legacies.
- Simplified code for transceive_data method.
WebGear_RTC:
- Improved handling of failed ICE connection.
- Made is_running variable globally available for internal use.
Helper:
- Added 4320p resolution support to dimensions_to_resolutions method.
- Implemented new delete_file_safe to safely delete files at given path.
- Replaced os.remove calls with delete_file_safe.
- Added support for filename prefixes in delete_ext_safe method.
- Improved and simplified create_blank_frame functions frame channels detection.
- Added logging parameter to capPropId function to forcefully discard any error(if required).
Setup.py:
- Added patch for numpy dependency, numpy recently dropped support for python 3.6.x legacies. See https://github.com/numpy/numpy/releases/tag/v1.20.0
- Removed version check on certain dependencies.
- Re-added aiortc to auto-install latest version.
Asyncio:
- Changed asyncio.sleep value to 0.
  - The amount of time sleep is irrelevant; the only purpose await asyncio.sleep() serves is to force asyncio to suspend execution to the event loop, and give other tasks a chance to run. Also, await asyncio.sleep(0) will achieve the same effect. https://stackoverflow.com/a/55782965/10158117
License:
- Dropped publication year range to avoid confusion. (Signed and Approved by @abhiTronix)
- Updated Vidgear license's year of first publication of the work in accordance with US copyright notices defined by Title 17, Chapter 4(Visually perceptible copies): https://www.copyright.gov/title17/92chap4.html

Breaking Updates/Changes 💥

💣 Virtually isolated all API specific dependencies, Now ImportError for API-specific dependencies will be raised only when any of them is missing at API's initialization.
💣 Renamed delete_safe to delete_ext_safe.
💣 Dropped support for frame_jpeg_quality, frame_jpeg_optimize, frame_jpeg_progressive attributes from WebGear.

Bug-fixes 🐛

CamGear:
- Hot-fix for Live Camera Streams:
  - Added new event flag to keep check on stream read.
  - Implemented event wait for read() to block it when source stream is busy.
  - Added and Linked THREAD_TIMEOUT with event wait timout.
  - Improved backward compatibility of new additions.
NetGear:
- Fixed Bidirectional Video-Frame Transfer broken with frame-compression:
  - Fixed return_data interfering with return JSON-data in receive mode.
  - Fixed logic.
- Fixed color-subsampling interfering with colorspace.
- Patched external simplejpeg bug. Issue: https://gitlab.com/jfolz/simplejpeg/-/issues/11
  - Added np.squeeze to drop grayscale frame's 3rd dimension on Client's end.
- Fixed bug that cause server end frame dimensions differ from client's end when frame compression enabled.
NetGear_Async:
- Fixed bug related asyncio queue freezing on calling join().
- Fixed ZMQ connection bugs in bidirectional mode.
- Fixed several critical bugs in event loop handling.
- Fixed several bugs in bidirectional mode implementation.
- Fixed missing socket termination in both server and client end.
- Fixed timeout parameter logic.
WebGear_RTC:
- Fixed stream freezes after web-page reloading:
  - Implemented new algorithm to continue stream even when webpage is reloaded.
  - Inherit and modified next_timestamp VideoStreamTrack method for generating accurate timestamps.
  - Implemented reset_connections callable to reset all peer connections and recreate Video-Server timestamps. (Implemented by @kpetrykin)
  - Added close_connection endpoint in JavaScript to inform server page refreshing.(Thanks to @kpetrykin)
  - Added exclusive reset connection node /close_connection in routes.
  - Added reset() method to Video-Server class for manually resetting timestamp clock.
  - Added reset_enabled flag to keep check on reloads.
  - Fixed premature webpage auto-reloading.
- Fixed web-page reloading bug after stream ended:
  - Disable webpage reload behavior handling for Live broadcasting.
  - Disable reload CI test on Windows machines due to random failures.
  - Improved handling of failed ICE connection.
- Fixed Assertion error bug:
  - Source must raise MediaStreamError when stream ends instead of returning None-type.
WebGear:
- Removed format specific OpenCV decoding and encoding support for WebGear.
Helper:
- Regex bugs fixed:
  - New improved regex for discovering supported encoders in get_supported_vencoders.
  - Re-implemented check for extracting only valid output protocols in is_valid_url.
- Bugfix related to OpenCV import:
  - Bug fixed for OpenCV import comparison test failing with Legacy versions and throwing ImportError.
- Fixed bug with create_blank_frame that throws error with gray frames.
- Implemented RSTP protocol validation as demuxer, since it's not a protocol but a demuxer.
- Removed redundant logger_handler, mkdir_safe, retrieve_best_interpolation, capPropId helper functions from asyncio package. Relatively imported helper functions from non-asyncio package.
- Removed unused aiohttp dependency.
- Removed asctime formatting from logging.
StreamGear:
- Fixed Multi-Bitrate HLS VOD streams:
  - Re-implemented complete workflow for Multi-Bitrate HLS VOD streams.
  - Extended support to both Single-Source and Real-time Frames Modes.
- Fixed bugs with audio-video mapping.
- Fixed master playlist not generating in output.
- Fixed improper -seg_duration value resulting in broken pipeline.
- Fixed expected aspect ratio not calculated correctly for additional streams.
- Fixed stream not terminating when provided input from external audio device.
- Fixed bugs related to external audio not mapped correctly in HLS format.
- Fixed OPUS audio fragments not supported with MP4 video in HLS.
- Fixed unsupported high audio bit-rate bug.
Setup.py:
- Fixed latest_version returning incorrect version for some PYPI packages.
- Removed latest_version variable support from simplejpeg.
- Fixed streamlink only supporting requests==2.25.1 on Windows.
- Removed all redundant dependencies like colorama, aiofiles, aiohttp.
Setup.cfg:
- Replaced dashes with underscores to remove warnings.

Related Pull Requests 🔧

PR #210
PR #215
PR #222
PR #223
PR #227
PR #231
PR #233
PR #237
PR #239
PR #243

vidgear - VidGear v0.1.7

Published by abhiTronix over 4 years ago

New Features:

WebGear API:
- Added a robust Live Video Server API that can transfer live video frames to any web browser on the network in real-time.
- Implemented a flexible asyncio wrapper around starlette ASGI Application Server.
- Added seamless access to various starlette's Response classes, Routing tables, Static Files, Template engine(with Jinja2), etc.
- Added a special internal access to VideoGear API and all its parameters.
- Implemented a new Auto-Generation Work-flow to generate/download & thereby validate WebGear API data files from its GitHub server automatically.
- Added on-the-go dictionary parameter in WebGear to tweak performance, Route Tables and other internal properties easily.
- Added new simple & elegant default Bootstrap Cover Template for WebGear Server.
- Added __main__.py to directly run WebGear Server through the terminal.
- Added new gif and related docs for WebGear API.
- Added and Updated various CI tests for this API.
NetGear_Async API
- Designed NetGear_Async asynchronous network API built upon ZeroMQ's asyncio API.
- Implemented support for state-of-the-art asyncio event loop uvloop at its backend.
- Achieved Unmatchable high-speed and lag-free video streaming over the network with minimal resource constraint.
- Added exclusive internal wrapper around VideoGear API for this API.
- Implemented complete server-client handling and options to use variable protocols/patterns for this API.
- Implemented support for all four ZeroMQ messaging patterns: i.e zmq.PAIR, zmq.REQ/zmq.REP, zmq.PUB/zmq.SUB, and zmq.PUSH/zmq.PULL.
- Implemented initial support for tcp and ipc protocols.
- Added new Coverage CI tests for NetGear_Async Network Gear.
- Added new Benchmark tests for benchmarking NetGear_Async against NetGear.
Asynchronous I/O Enhancements
- Added asyncio package to vidgear for handling asynchronous APIs.
- Moved WebGear API(webgear.py) to asyncio and created separate asyncio helper.py for it.
- Various Performance tweaks for Asyncio APIs with concurrency within a single thread.
- Moved __main__.py to asyncio for easier access to WebGear API through the terminal.
- Updated setup.py with new dependencies and separated asyncio dependencies.
General Enhancements:
- Added new highly-precise Threaded FPS class for accurate benchmarking with time.perf_counter python module.
- Added a new Gitter community channel.
- Added a new Reducer function to reduce the frame size on-the-go.
- Add Flake8 tests to Travis CI to find undefined names. (PR by @cclauss)
- Added a new unified logging handler helper function for vidgear.

Updates/Improvements:

Re-implemented and simplified logic for NetGear Async server-end.
Added new dependencies for upcoming asyncio updates to setup.py.
Added retry function and replaced wget with curl for Linux test envs.
Bumped OpenCV to latest 4.2.0-dev for Linux test envs.
Updated YAML files to reflect new changes to different CI envs.
Separated each API logger with a common helper method to avoid multiple copies.
Limited Importing OpenCV API version check's scope to helper.py only.
Implemented case for incorrect color_space value in ScreenGear API.
Removed old conflicting logging formatter with a common method and expanded logging.
Improved and added shutdown function for safely stopping frame producer threads in WebGear API.
Re-implemented and simplified all CI tests with maximum code-coverage in mind.
Replaced old mkdir function with new mkdir_safe helper function for creating directories safely.
Updated ReadMe.md with updated diagrams, gifs and information.
Improve, structured and Simplified the Contribution Guidelines.
Bundled CI requirements in a single command.(Suggested by @cclauss)
Replaced line endings CRLF with LF endings.
Added dos2unix for Travis OSX envs.
Bumped Codecov to maximum.

Breaking Updates / Improvements / Changes

⚠️ Dropped support for Python 3.5 and below legacies. (See issue #99)
Dropped and replaced Python 3.5 matrices with new Python 3.8 matrices in all CI environments.
Implemented PEP-8 Styled Black formatting throughout the source-code.
Limited protocols support to tcp and ipc only, in NetGear API.

Fixes:

Fixed Major NetGear_Async bug where __address and __port are not set in async mode.(PR by @otter-in-a-suit)
Fixed Major PiGear Color-space Conversion logic bug.
Workaround for CAP_IMAGES: error in YouTube Mode.
Replaced incorrect terminate() with join() in PiGear.
Removed uvloop for windows as still NOT yet supported.
Refactored Asynchronous Package name async to asyncio, since it is used as Keyword in python>=3.7*(raises SyntaxError)*.
Fixed unfinished close of event loops bug in WebGear API.
Fixed NameError in helper.py.
Added fix for OpenCV installer failure on Linux test envs.
Fixed undefined NameError in helper.py context. (@cclauss)
Fixed incorrect logic while pulling frames from ScreenGear API.
Fixed missing functions in __main__.py.
Fixed Typos and definitions in docs.
Added missing camera_num parameter to VideoGear.
Added OpenSSL's [SSL: CERTIFICATE_VERIFY_FAILED] bug workaround for macOS envs.
Removed download_url meta from setup.py.
Removed PiGear from CI completely due to hardware emulation limitation.
Removed VideoCapture benchmark tests for macOS envs.
Removed trivial __main__.py from codecov.
Removed several redundant try-catch loops.
Renamed youtube_url_validation as youtube_url_validator.
Several minor wrong/duplicate variable definitions and various bugs fixed.
Fixed, Improved & removed many Redundant CI tests for various APIs.

Pull requests(PR) involved:

PR #88
PR #91
PR #93
PR #95
PR #98
PR #101
PR #114
PR #118
PR #124

⚠️ PyPi Release does NOT contain Tests and Scripts!

vidgear - VidGear 0.1.7-alpha0

Published by abhiTronix almost 5 years ago

Fixes:

Fixed critical bug: undefined name self in helper.py context which will raise NameError. (@cclauss)

Pull requests(PR) involved:

#88

⚠️ PyPi Release does NOT contain Tests and Scripts!

vidgear - VidGear v0.1.6

Published by abhiTronix almost 5 years ago

New Features:

NetGear API:
- Added powerful ZMQ Authentication & Data Encryption features for NetGear API:
  - Added exclusive secure_mode param for enabling it.
  - Added support for the two most powerful Stonehouse & Ironhouse ZMQ security mechanisms.
  - Added smart auth-certificates/key generation and validation features
- Implemented Robust Multi-Server support for NetGear API:
  - Enables Multiple Server messaging support with a single client.
  - Added exclusive multiserver_mode param for enabling it.
  - Added support for REQ/REP & PUB/SUB patterns for this mode.
  - Added ability to send additional data of any datatype along with the frame in realtime in this mode.
- Introducing exclusive Bi-Directional Mode for bidirectional data transmission:
  - Added new return_data parameter to recv() function.
  - Added new bidirectional_mode attribute for enabling this mode.
  - Added support for PAIR & REQ/REP patterns for this mode
  - Added support for sending data of any python datatype.
  - Added support for message parameter for non-exclusive primary modes for this mode.
- Implemented compression support with on-the-fly flexible frame encoding for the Server-end:
  - Added initial support for JPEG, PNG & BMP encoding formats
  - Added exclusive options attribute compression_format & compression_param to tweak this feature
  - Client-end will now decode frame automatically based on the encoding as well as support decoding flags
- Added force_terminate attribute flag for handling force socket termination at the Server-end if there's latency in the network.
- Implemented new Publish/Subscribe(zmq.PUB/zmq.SUB) pattern for seamless Live Streaming in NetGear API.
PiGear API:
- Added new threaded internal timing function for PiGear to handle any hardware failures/frozen threads.
- PiGear will not exit safely with SystemError if Picamera ribbon cable is pulled out to save resources.
- Added support for new user-defined HWFAILURE_TIMEOUT options attributes to alter timeout.
VideoGear API:
- Added framerate global variable and removed redundant function.
- Added CROP_N_ZOOM attribute in Videogear API for supporting Crop and Zoom stabilizer feature.
WriteGear API: Added new execute_ffmpeg_cmd function to pass a custom command to its FFmpeg pipeline.
Stabilizer class:
- Added new Crop and Zoom feature.
  - Added crop_n_zoom param for enabling this feature.
- Updated docs.
CLI & Tests updates:
- Replaced python 3.5 matrices with the latest python 3.8 matrices in the Linux environment.
- Added full support for Codecov in all CLI environments.
- Updated OpenCV to v4.2.0-pre(master branch).
- Added various Netgear API tests.
- Added initial Screengear API test.
- More test RTSP feeds added with better error handling in the CamGear network test.
- Added tests for ZMQ authentication certificate generation.
- Added badge and Minor doc updates.
Added VidGear's official native support for macOS environments.

Updates/Improvements:

Replace print logging commands with python's logging module completely.
Implemented encapsulation for class functions and variables on all gears.
Updated support for screencasting from multiple/all monitors in ScreenGear API.
Updated ScreenGear API to use Threaded Queue Mode by default, thereby removed redundant THREADED_QUEUE_MODE param.
Updated bash script path to download test dataset in $TMPDIR rather than $HOME directory for downloading test data.
Implemented better error handling of colorspace in various videocapture APIs.
Updated bash scripts, Moved FFmpeg static binaries to github.com.
Updated bash scripts, Added additional flag to support un-secure apt sources.
CamGear API will now throw RuntimeError if the source provided is invalid.
Updated threaded Queue mode in CamGear API for more robust performance.
Added new camera_num to support multiple Picameras.
Moved thread exceptions to the main thread and then re-raised.
Added alternate GitHub mirror for FFmpeg static binaries auto-installation on windows oses.
Added colorlog python module for presentable colored logging.
Replaced traceback with sys.exc_info.
Overall APIs Code and Docs optimizations.
Updated Code Readability and Wiki Docs.
Updated ReadMe & Changelog with the latest changes.
Updated Travis CLI Tests with support for the macOS environment.
Reformatted & implemented necessary macOS related changes and dependencies in travis.yml.

Breaking Updates / Improvements / Changes

⚠️ Python 2.7 legacy support dropped completely.
⚠️ Source-code Relicensed to Apache 2.0 License.
Python 3+ are only supported legacies for installing Vidgear v0.1.6 and above.
Python 2.7 and 3.4 legacies support dropped from VidGear CLI tests.

Fixes

Reimplemented Pub/Sub pattern for smoother performance on various networks.
Fixed Assertion error in CamGear API during colorspace manipulation.
Fixed random freezing in Secure Mode and several related performance updates
Fixed multiserver_mode not working properly over some networks.
Fixed assigned Port address ignored bug (commit 073bca1).
Fixed several wrong definition bugs from NetGear API(commit 8f7153c).
Fixed unreliable dataset video URL(rehosted file on github.com).
Disabled overwrite_cert for client-end in NetGear API.
Disabled Universal Python wheel builds in setup.cfg file.
Removed duplicate code to import MSS(@BoboTiG) from ScreenGear API.
Eliminated unused redundant code blocks from the library.
Fixed Code indentation in setup.py and updated new release information.
Fixed code definitions & Typos.
Fixed several bugs related to secure_mode & multiserver_mode Modes.
Fixed various macOS environment bugs.

Pull requests(PR) involved:

PR #39
PR #42
PR #44
PR #52
PR #55
PR #62
PR #67
PR #72
PR #77
PR #78
PR #82
PR #84

⚠️ PyPi Release does NOT contain Tests and Scripts!

vidgear - VidGear v0.1.5

Published by abhiTronix about 5 years ago

New Features:

Added new ScreenGear API, supports Live ScreenCasting.
Added new NetGear API, aids real-time frame transfer through messaging(ZmQ) over network.
Added new new Stabilizer Class, for minimum latency Video Stabilization with OpenCV.
Added Option to use VidGear API's standalone.
Added Option to use VideoGear API as internal wrapper around Stabilizer Class.
Added new parameter stabilize to VidGear API, to enable or disable Video Stabilization.
Added support for **option dict attributes to update VidGear's video stabilizer parameters directly.
Added brand new VidGear logo and functional block diagram (.svg) in readme.md
Added new pictures and GIFs for improving readme.md readability
Added new contributing.md and changelog.md for reference.
Added collections.deque import in Threaded Queue Mode for performance consideration
Added new install_opencv.sh bash scripts for Travis cli, to handle OpenCV installation.
Added new Project Issue & PR Templates
Added new Sponsor Button(FUNDING.yml)

Updates/Improvements:

Updated New dependencies: mss, pyzmq and rejected redundant ones.
Revamped and refreshed look for readme.md and added new badges.
Updated Releases Documentation completely.
Updated CLI tests for new changes
Updated Code Documentation.
Updated bash scripts and removed redundant information
Updated Youtube video URL in tests
Completely Reformatted and Updated Wiki Docs with new changes.

Breaking Updates / Improvements / Changes

Implemented experimental Threaded Queue Mode(a.k.a Blocking Mode) for fast, synchronized, error-free multi-threading.
Renamed bash script pre-install.sh to prepare_dataset.sh - downloads opensourced test datasets and static FFmpeg binaries for debugging.
Changed script folder location to bash/script.
Python 3.4 removed from Travis CLI tests.

Fixes

Temporarily fixed Travis CLI bug: Replaced opencv-contrib-python with OpenCV built from scratch as dependency.
Fixed CLI Timeout Bug: Disable Threaded Queue Mode for CLI Tests
Fixes sys.stderr.close() throws ValueError bug: Replaced sys.close() with DEVNULL.close()
Fixed Youtube Live Stream bug that return NonType frames in CamGear API.
Fixed NoneType frames bug in PiGear class on initialization.
Fixed Wrong function definitions
Removed /xe2 unicode bug from Stabilizer class.
Fixed **output_params KeyError bug in WriteGear API
Fixed subprocess not closing properly on exit in WriteGear API.
Fixed bugs in ScreenGear: Non-negative monitor values
Fixed missing import, typos, wrong variable definitions
Removed redundant hack from setup.py
Fixed Minor YouTube playback Test CLI Bug
Fixed new Twitter Intent
Fixed bug in bash script that not working properly due to changes at server end.

Pull requests(PR) involved:

PR #17
PR #21
PR #22
PR #27
PR #31
PR #32
PR #33
PR #34

vidgear - VidGear v0.1.4

Published by abhiTronix over 5 years ago

New Features:

Added WriteGear API: for enabling lossless video encoding and compression(built around FFmpeg and OpenCV Video Writer)
Added YouTube direct Video Pipelining to OpenCV(YouTube Mode) in CamGear API
Added new y_tube to access YouTube Mode in CamGear API.
Added flexible Output file Compression control capabilities in compression-mode(WriteGear).
Added -output_dimensions special parameter to WriteGear API.
Added new helper.py to handle special helper functions.
Added feature to auto-download and configure FFmpeg Static binaries(if not found) on Windows platforms.
Added -input_framerate special parameter to WriteGear class to change/control output constant framerate in compression mode(WriteGear).
Added new Direct Video colorspace Conversion capabilities in CamGear and PiGear API.
Added new framerate class variable for CamGear API, to retrieve input framerate.
Added new parameter backend - changes the backend of CamGear's API
Added automatic required prerequisites installation ability, when installation from source.
Added Travis CLI Complete Integration for Linux-based Testing for VidGear.
Added and configured travis.yml
Added Appveyor CLI Complete Integration for Windows-based Testing in VidGear.
Added and configured new appveyor.yml
Added new bash script Pre-install.sh to download opensourced test datasets and static FFmpeg binaries for debugging.
Added several new Tests(including Benchmarking Tests) for each API for testing with pytest.
Added Say Thank you! badge to readme.

Updates/Improvements:

Removed redundant dependencies
Updated youtube-dl as a dependency, as required by pafy's backend.
Updated common VideoGear API with new parameter.
Update robust algorithm to auto-detect FFmpeg executables and test them, if failed, auto fallback to OpenCV's VideoWriter API.
Improved system previously installed OpenCV detection in setup.py.
Updated setup.py with hack to remove bullets from pypi description.
Updated Code Documentation
Reformatted & Modernized readme.md with new badges.
Reformatted and Updated Wiki Docs.

Breaking Updates / Improvements / Changes

Bugs Patched: Removed unnecessary -height and -width parameter from CamGear API.
Replaced dependency opencv-python with opencv-contrib-python completely

Fixes

Windows Cross-Platform fix: replaced dependency os with platform in setup.py.
Fixed Bug: Arises due to spaces in input **options/**output_param dictionary keys.
Fixed several wrong/missing variable & function definitions.
Fixed code uneven indentation.
Fixed several typos in docs.

Pull requests(PR) involved:

PR #7
PR #8
PR #10
PR #12

⚠️ PyPi Release does NOT contain Tests and Scripts!

vidgear - VidGear v0.1.3

Published by abhiTronix over 5 years ago

Fixes

Patched Major PiGear Bug: Incorrect import of PiRGBArray function in PiGear Class
Several fixes for backend picamera API handling during frame capture(PiGear)
Fixed missing frame variable initialization.
Fixed minor typos

Pull requests(PR) Involved:

PR #6
PR #5

Tip 💡 Go through each PR to see what has changed and when!

vidgear - VidGear v0.1.2

Published by abhiTronix over 5 years ago

New Features:

Added easy Source manipulation feature in CamGear API, to control features like resolution, brightness, framerate etc.
Added new **option parameter to CamGear API, provides the flexibility to manipulate input stream directly.
Added new parameters for Camgear API for time delay and logging.
Added new Logo to readme.md
Added new Wiki Documentation.

Updates/Improvements:

Reformatted readme.md.
Updated Wiki Docs with new changes.

Fixes:

Improved Error Handling in CamGear & PiGear API.
Fixed minor typos in docs.

Pull requests(PR) Involved:

PR #4

Tip 💡 Go through each PR to see what has changed and when!

What's Changed

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

Related Pull Requests 🔧

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

Related Pull Requests 🔧

📓 Complete Release Notes can be found here ↗️

New Features ✨

Updates/Improvements ⚡️

Breaking Updates/Changes 💥

Bug-fixes 🐛

Related Pull Requests 🔧

New Features ✨

Updates/Improvements 🔧

Breaking Updates/Changes 💥

Bug-fixes 🐛

Pull Requests

New Features

Updates/Improvements

Breaking Updates/Changes

Bug-fixes

Pull Requests

New Features

Updates/Improvements

Breaking Updates/Changes

Bug-fixes

Pull Requests

New Features

Updates/Improvements

Breaking Updates/Changes

Bug-fixes

Pull Requests

New Features:

Updates/Improvements:

Breaking Updates / Improvements / Changes

Fixes:

Pull requests(PR) involved:

Fixes:

Pull requests(PR) involved:

New Features:

Updates/Improvements:

Breaking Updates / Improvements / Changes

Fixes

Pull requests(PR) involved:

New Features:

Updates/Improvements:

Breaking Updates / Improvements / Changes

Fixes

Pull requests(PR) involved:

New Features: