From dbe1ffd14b6c754ec95a4f7c6a1ce47e40b8eaed Mon Sep 17 00:00:00 2001 From: DarthSim Date: Mon, 17 Aug 2020 22:30:00 +0600 Subject: [PATCH] Add docs for new video thumbnails configs & update changelog --- CHANGELOG.md | 7 +++++++ docs/configuration.md | 4 ++++ 2 files changed, 11 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3585b0bb..2064e8c8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,13 @@ - Ability to skip processing of some formats. See [Skip processing](https://docs.imgproxy.net/#/configuration?id=skip-processing). - (pro) [video_thumbnail_second](https://docs.imgproxy.net/#/generating_the_url_advanced?id=video-thumbnail-second) processing option. - (pro) [background_alpha](https://docs.imgproxy.net/#/generating_the_url_advanced?id=background-alpha) processing option. +- (pro) `IMGPROXY_VIDEO_THUMBNAIL_PROBE_SIZE` and `IMGPROXY_VIDEO_THUMBNAIL_MAX_ANALYZE_DURATION` configs. + +### Changed +- Speed up generation of video thumbnails with large timestamps. + +### Fix +- Fix thumbnails generation of some videos. ## [2.14.1] - 2020-07-22 ### Fix diff --git a/docs/configuration.md b/docs/configuration.md index 241a276d..df454cc0 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -144,6 +144,10 @@ imgproxy Pro can extract specific frames of videos to create thumbnails. The fea * `IMGPROXY_ENABLE_VIDEO_THUMBNAILS`: pro then true, enables video thumbnails generation. Default: false; * `IMGPROXY_VIDEO_THUMBNAIL_SECOND`: pro the timestamp of the frame in seconds that will be used for a thumbnail. Default: 1. +* `IMGPROXY_VIDEO_THUMBNAIL_PROBE_SIZE`: pro the maximum amount of bytes used to determine the format. Lower values can decrease memory usage but can produce inaccurate data or even lead to errors. Default: 5000000. +* `IMGPROXY_VIDEO_THUMBNAIL_MAX_ANALYZE_DURATION`: pro the maximum of milliseconds used to get the stream info. Low values can decrease memory usage but can produce inaccurate data or even lead to errors. When set to 0, the heuristic is used. Default: 0. + +**⚠️Warning:** Though using `IMGPROXY_VIDEO_THUMBNAIL_PROBE_SIZE` and `IMGPROXY_VIDEO_THUMBNAIL_MAX_ANALYZE_DURATION` can lower the memory footprint of video thumbnails generation, you should use them in production only when you know what are you doing. ## Watermark