2023-05-13, 15:47
Art types
There are three main layouts for the views in Copacetic: poster (4:3), fanart (16:9) and square (1:1). In addition to the regular artwork types, Copacetic has four custom art types.
Poster views will show keyart.jpg art instead of poster.jpg if it is present in your library and you have chosen to prefer it in Settings > Copacetic > General. Otherwise it will fall back to poster.jpg and then thumb.jpg/icon.
Square views will show square.jpg art if it is present in your library. Otherwise it will fall back to a centered crop of fanart.jpg.
For clearlogo views, clearlogo-alt.jpg will be displayed if present and light theme is selected. It provides an opportunity to ensure that the standard light-coloured logos don't clash with the light coloured background.
clearlogo-billboard.jpg will be displayed only on Billboard view and will be preferred to clearlogo.png. It is designed to give an opportunity to have a different logo when overlayed on top of fanart instead of the black/white background. For example, if you have a light coloured logo, as is standard, for clearlogo.png that shows well on dark backgrounds, but you want to use a dark logo on a specific fanrt:
Whitelisting Custom Art types
Before you can use these custom art types, you must first ensure they are whitelisted by Kodi so it knows to scan for them. There are two ways you can do this:
1) Go to Settings > Copacetic > General > Recommended Kodi Settings. Here you can toggle on off each of the settings changes recommended for optimal Copacetic usage.
2) Alternatively you can add these art types to the whitelists yourself by going to Settings > Media > Videos > Artwork. Here you'll need to set Artwork Level to 'Custom', then you can add the custom art types to each whitelist (movies, tv shows). You can also add custom clearlogo support for artists if you do the same for the whitelist under Settings > Media > Music > Artwork. You don't need square.jpg as artist thumbs are already 1:1 by default or keyart.jpg as 4:3 poster sizes aren't used for in the music section.
Artwork Service
Copacetic can run a background service that does two things. It firstly provides fanart slideshows for use as background artwork on the home screen and other various windows. Secondly, it can crop clearlogos and apply the dominant colour of a clearlogo to window furniture such as flags and text dividers. Note: If you are on a low powered device, disabling the clearlogo cropper might help performance. The background slideshows will only run when the slideshow is visible on screen so there should be no performance hit when browsing/watching media.
Clearlogo cropper does what it sounds like and crops the empty space around clearlogos the first time they are displayed. Your artwork is not changed, a copy is made and stored in the addon data folder. As long as the clearlogos are not very high resolutions, the cropping process shouldn't be noticeable.For really large sizes (e.g. 4000 x 1500) it might take a fraction of a second. But once it has been done the first time, the cropped clearlogo will be used from now on unless you empty the cache in Settings > Copacetic > General.
Dominant colour from the clearlogo is used to colour flags and text dividers. The colour will only be used if there is enough contrast between the colour and the background. You can adjust the thresholds for this under Settings > Copacetic > General > under Enable clearlogo cropper. The cropper must be running to use the coloriser. The way the thresholds work is. The bottom threshold (default 65) is the luminosity out of 1000 that a colour must exceed to be displayed on the dark background. The high threshold (default 460) is the luminosity out of 1000 tht a colour must NOT exceed to be shown on the light background. You can adjust these ranges to your own preference, but the defaults should be fine for most people.
Uncropped and uncolorised
Cropped and colorised
Multiart
All art types apart from clearlogos support multiart. Up to 15 images will be shown in a slideshow for the focused item in place of the thumbnail. You can enable this under Settings > Copacetic > Extras and choose the interval between each image being shown.
Just make sure your multiart is named correctly so Kodi can scan it when you add an item to your library or go to Information > Refresh.
You just need to number the art types sequentially so fanart.jpg is followed by fanart1.jpg. keyart.jpg is followed by keyart1.jpg. The additional artwork is shown in a random order, but it will only work if you have atleast xxx1.jpg present.
Here's what it should look like:
There are three main layouts for the views in Copacetic: poster (4:3), fanart (16:9) and square (1:1). In addition to the regular artwork types, Copacetic has four custom art types.
Poster views will show keyart.jpg art instead of poster.jpg if it is present in your library and you have chosen to prefer it in Settings > Copacetic > General. Otherwise it will fall back to poster.jpg and then thumb.jpg/icon.
Square views will show square.jpg art if it is present in your library. Otherwise it will fall back to a centered crop of fanart.jpg.
For clearlogo views, clearlogo-alt.jpg will be displayed if present and light theme is selected. It provides an opportunity to ensure that the standard light-coloured logos don't clash with the light coloured background.
clearlogo-billboard.jpg will be displayed only on Billboard view and will be preferred to clearlogo.png. It is designed to give an opportunity to have a different logo when overlayed on top of fanart instead of the black/white background. For example, if you have a light coloured logo, as is standard, for clearlogo.png that shows well on dark backgrounds, but you want to use a dark logo on a specific fanrt:
Whitelisting Custom Art types
Before you can use these custom art types, you must first ensure they are whitelisted by Kodi so it knows to scan for them. There are two ways you can do this:
1) Go to Settings > Copacetic > General > Recommended Kodi Settings. Here you can toggle on off each of the settings changes recommended for optimal Copacetic usage.
2) Alternatively you can add these art types to the whitelists yourself by going to Settings > Media > Videos > Artwork. Here you'll need to set Artwork Level to 'Custom', then you can add the custom art types to each whitelist (movies, tv shows). You can also add custom clearlogo support for artists if you do the same for the whitelist under Settings > Media > Music > Artwork. You don't need square.jpg as artist thumbs are already 1:1 by default or keyart.jpg as 4:3 poster sizes aren't used for in the music section.
Artwork Service
Copacetic can run a background service that does two things. It firstly provides fanart slideshows for use as background artwork on the home screen and other various windows. Secondly, it can crop clearlogos and apply the dominant colour of a clearlogo to window furniture such as flags and text dividers. Note: If you are on a low powered device, disabling the clearlogo cropper might help performance. The background slideshows will only run when the slideshow is visible on screen so there should be no performance hit when browsing/watching media.
Clearlogo cropper does what it sounds like and crops the empty space around clearlogos the first time they are displayed. Your artwork is not changed, a copy is made and stored in the addon data folder. As long as the clearlogos are not very high resolutions, the cropping process shouldn't be noticeable.For really large sizes (e.g. 4000 x 1500) it might take a fraction of a second. But once it has been done the first time, the cropped clearlogo will be used from now on unless you empty the cache in Settings > Copacetic > General.
Dominant colour from the clearlogo is used to colour flags and text dividers. The colour will only be used if there is enough contrast between the colour and the background. You can adjust the thresholds for this under Settings > Copacetic > General > under Enable clearlogo cropper. The cropper must be running to use the coloriser. The way the thresholds work is. The bottom threshold (default 65) is the luminosity out of 1000 that a colour must exceed to be displayed on the dark background. The high threshold (default 460) is the luminosity out of 1000 tht a colour must NOT exceed to be shown on the light background. You can adjust these ranges to your own preference, but the defaults should be fine for most people.
Uncropped and uncolorised
Cropped and colorised
Multiart
All art types apart from clearlogos support multiart. Up to 15 images will be shown in a slideshow for the focused item in place of the thumbnail. You can enable this under Settings > Copacetic > Extras and choose the interval between each image being shown.
Just make sure your multiart is named correctly so Kodi can scan it when you add an item to your library or go to Information > Refresh.
You just need to number the art types sequentially so fanart.jpg is followed by fanart1.jpg. keyart.jpg is followed by keyart1.jpg. The additional artwork is shown in a random order, but it will only work if you have atleast xxx1.jpg present.
Here's what it should look like:
