For a more dialed-in experience than the Screenshot plugin, our Image Display plugin lets you generate custom graphics that TRMNLs convert to e-ink friendly screens.
Use cases
Family photo album at
mysite.com/hidden/family.jpg?auth=qwerty
Home Assistant dashboard
Deer cam CCTV
To get started with Image Display, navigate to Plugins > Image Display and input a URL to your image, which can be in any format or size.
Where to host images
We've heard mixed reports of sites like imgur.com being unreliable. Potentially they use anti-scraping tech that treats TRMNL like a robot. We don't deserve that.
So you're welcome to point to Google Drive instead. Simply upload an image, share it to "Anyone with the link," then copy + paste the link like so:
Here's the above example if you'd like to try it:
β
https://drive.google.com/file/d/164qYbGtnzQq_PDLE-eB6cu4a6mIT8DzN/view?usp=sharing
Ensuring content changes
TRMNL syncs plugin content according to your plugin's refresh interval, forr example every 15 minutes. But we only generate new screen renders if the content changes. Learn more about how this works here.
For most plugins, this is straightforward as the underlying data will surely be different if something happens. But with images, we use the headers etag
with If-None-Match
and last-modified
with If-Modified-Since
to determine if we need to process that image. Adjust your image endpoint to support these headers.
Alternatively you can use our Alias plugin and TRMNL will serve your generated image directly. Just note that this method requires you to format images to our exact specifications, while Image Display does this for you automatically.