Skip to content

Image Fit

This controls how the image will fit on your screen

Settings

Key Value
CONFIG image_fit
ENV KIOSK_IMAGE_FIT
URL image_fit
VALUE contain | cover | none
DEFAULT contain
Using with config.yaml file
image_fit: contain
Using with ENV in your docker-compose file
environment:
KIOSK_IMAGE_FIT: contain
Using with url queries
http://{URL}?image_fit=contain

The image keeps its aspect ratio, but is resized to fit the whole screen. If the image is smaller than your screen, there will be some fuzzyness to your image.

The image will cover the whole screen. To achieve this the image will mostly likely have some clipping/cropping and if the image is smaller than your screen, there will be some fuzzyness to your image.

The image is centered and displayed “as is”. If the image is larger than your screen it will be scaled down to fit your screen.