From a9e11fcfebbb80f3a0fe90664856a3398c7b5b6a Mon Sep 17 00:00:00 2001 From: Daniel Barber Date: Wed, 26 Feb 2020 19:23:59 -0500 Subject: [PATCH] Add some info about valid quality levels --- docs/plugins/embedart.rst | 9 ++++++--- docs/plugins/fetchart.rst | 4 +++- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/plugins/embedart.rst b/docs/plugins/embedart.rst index bd87abed6..ece5e0350 100644 --- a/docs/plugins/embedart.rst +++ b/docs/plugins/embedart.rst @@ -59,9 +59,12 @@ file. The available options are: caveats about image resizing. Default: 0 (disabled). - **quality**: The quality level to use when encoding the image file when - downscaling to ``maxwidth``. The default behaviour depends on the method used - to scale the images. ImageMagick tries to estimate the input image quality and - uses 92 if it cannot be determined. Pillow defaults to 75. + downscaling to ``maxwidth``. Can be a number from 1-100 or 0 to disable. + Higher numbers result in better image quality while lower numbers will result + in smaller files. 65-75 is a good starting point. The default behaviour + depends on the method used to scale the images. ImageMagick tries to estimate + the input image quality and uses 92 if it cannot be determined. Pillow + defaults to 75. Default: 0 (disabled) - **remove_art_file**: Automatically remove the album art file for the album after it has been embedded. This option is best used alongside the diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst index 23362aee0..8c5d0eb7b 100644 --- a/docs/plugins/fetchart.rst +++ b/docs/plugins/fetchart.rst @@ -43,7 +43,9 @@ file. The available options are: too big. The resize operation reduces image width to at most ``maxwidth`` pixels. The height is recomputed so that the aspect ratio is preserved. - **quality**: The quality level to use when encoding the image file when - downscaling to ``maxwidth``. + downscaling to ``maxwidth``. Can be a number from 1-100 or 0 to disable. + Higher numbers result in better image quality while lower numbers will result + in smaller files. 65-75 is a good starting point. Default: 0 (disabled) - **enforce_ratio**: Only images with a width:height ratio of 1:1 are considered as valid album art candidates if set to ``yes``.