Image Display

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.

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.

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:​

You can also use Dropbox to host your images. When sharing a Dropbox link, you'll need to append ?raw=1 to the URL. Otherwise, the link points to a preview webpage rather than the actual image file, which won't work with the plugin. For example:

Read more about forcing downloads from Dropbox here: https://help.dropbox.com/share/force-download

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.