Image Plugin (plugin-image)

The official Image Plugin turns your Zenso frame into a living art piece. It automatically adapts photos to your frame’s aspect ratio, applies advanced dithering tuned for e-paper pigments, and cycles photos on a calm schedule.

Source Code & Repository

The official Image Plugin is completely open source under the MIT license.

View plugin-image on GitHub →

Key Features

• Smart Auto-Rotation: Reads EXIF orientation tags so photos never appear sideways or inverted.
• Multiple Photo Sources: Connect Google Photos, Immich, Nextcloud, or upload directly via the Web Panel.
• Optimized Dithering: Floyd-Steinberg error-diffusion algorithm calibrated for multi-color e-paper pigments.
• Flexible Sizing: Fully responsive across Full Screen, 50/50 split, and quadrant widget layouts.

Panel Configuration Options

Configure the following settings in the Zenso Web Panel under Widget Settings:

• Source Collection: Select the photo album or cloud provider feed.
• Shuffle Mode: Sequential or random photo rotation on each refresh.
• Scaling Mode: Crop to Fill (immersive full-bleed) or Fit with Matting (preserves full composition with calming paper borders).
• Contrast & Vibrancy: Fine-tune contrast and saturation to pop on reflective pigment displays.

Aspect Ratios & Matting

Photographs rarely match the physical 16:9 or 5:3 aspect ratio of your display. The Image Plugin intelligently computes matting using background tone averaging or clean museum borders, avoiding ugly letterboxing artifacts.

E-Paper Color Dithering

Because physical e-paper displays have a fixed palette of physical color pigments (such as 6-color Spectra 6 or 7-color ACeP), the plugin processes every photograph through a tailored quantization pipeline before transmission, ensuring smooth skin tones, natural sky gradients, and crisp detail.

Developer & Manifest Reference

The plugin is built with LiquidJS and Sharp. View the full manifest schema and implementation at github.com/zensoink/plugin-image.