This plugin is a companion to the TRMNL Home Assistant add-on that captures screenshots of your dashboards, applies dithering algorithms optimized for e-paper screens, and sends them to TRMNL.
Step 1 - Add the Plugin
Inside TRMNL, navigate to Plugins > Home Assistant Screenshot.
Step 2 - Copy Your Webhook URL
After saving, you'll see a unique Webhook URL in your plugin settings.
This URL is private to you. Treat it like a password. Anyone with this URL can update your display.
Step 3 - Install the Add-on
Navigate to the TRMNL Home Assistant add-on and click:
OR
In Home Assistant, go to Settings > Add-ons > Add-on Store.
Click the three-dot menu, select "Repositories", and add:
Then find "TRMNL HA" in the list and click Install.
Step 4 - Configure
Go to Settings > Add-ons > TRMNL HA > Configuration.
Create a Long-Lived Access Token (Profile > Long-Lived Access Tokens) and paste it in the "access_token" field. Save and start the add-on.
Add HA to the sidebar by using the dedicated toggle.
Step 5 - Configure
Open "TRMNL HA" from the sidebar, create a schedule, pick your device preset using the preview to confirm it looks good on device, and paste your Webhook URL into the allocated field.
Step 6 - You're Done!
Based on your schedule and device refresh settings, you'll see your dashboard on the display very soon.
Note: Use "Send Now" to test immediately. Device presets auto-configure the right size and dithering for your display.
Troubleshooting
Display not updating?
Check that your schedule is enabled and the webhook URL is correct. Click "Send Now" to test. Also check add-on logs at Settings > Add-ons > TRMNL HA > Log
Screenshot looks wrong?
Try increasing the "Wait" time for complex dashboards. Use a high-contrast theme like "Graphite". Fine-tune the image generation.
HA connection failing?
Verify your access token and home assistant url is correct. The Web UI shows connection status with details.
Need more help?