trmnl

What This Skill Does

The trmnl skill empowers OpenClaw agents to design, generate, and push custom visual content directly to TRMNL e-ink display devices. By leveraging the TRMNL CSS framework, this skill transforms text and data into high-contrast, professional-grade layouts suitable for low-power, high-resolution e-ink screens. The skill integrates directly with the trmnl CLI to handle the end-to-end process: from generating structured HTML templates that adhere to specific device constraints, to validating payload sizes against Tier limits, and finally pushing updates to configured webhooks.

Installation

To integrate this skill, use the following command in your terminal: clawhub install openclaw/skills/skills/peetzweg/trmnl

Ensure you have the TRMNL CLI installed globally via npm (npm install -g trmnl-cli@latest) and that you have configured at least one webhook plugin using trmnl plugin add to establish a connection between your command line environment and your physical display device.

Use Cases

• Personal Dashboards: Display real-time weather, calendar events, or stock market tickers on your desk.
• System Monitoring: Visualize server uptime, build status, or network traffic directly on a physical wall-mounted display.
• Productivity Notifications: Send task reminders or focus-timer alerts that persist even when your computer screen is turned off.
• Contextual Information: Automatically update a display to show current sprint goals, daily affirmations, or project status indicators.

Example Prompts

1. "Create a dashboard for my desk TRMNL showing the current weather in Tokyo and the next two items on my Google Calendar."
2. "Display a 'System Status' screen on my office device showing the CPU usage, memory load, and current network throughput."
3. "Generate a clean, minimalist layout for my TRMNL that displays the current sprint goal and a progress bar representing the project completion percentage."

Tips & Limitations

• Mind the Payload: E-ink plugins have strict size limits (2KB for Free, 5KB for TRMNL+). Always use trmnl validate before pushing to avoid rejected updates.
• CSS Utility Usage: Utilize the pre-defined TRMNL framework classes for typography, flexbox, and grid layouts to ensure your content looks pixel-perfect on 800x480 screens.
• Plugin Structure: Follow the standard title_bar and layout patterns defined in the framework to maintain consistency across all your displayed content.
• Persistence: E-ink displays are static; design your content to be high-contrast and easy to read at a glance, avoiding excessive detail that might get lost on a 2-bit grayscale screen.