TRMNL: Blog

Framework is now Open Source

2026-08-13T00:00:00+00:00

we started with an 800x480, 1-bit display. it didn't take long to realize: designing for low resolution ePaper panels is tricky. thus Framework was born:
https://trmnl.com/framework

fast forward a few years, today we host 93,108 private plugins delivering 281,872 instances to 10s of thousands of devices around the world every 5-15 minutes.

which is why i'm thrilled to announce that our entire design system is now open source.
https://github.com/usetrmnl/trmnl-framework

after thousands of iterations, here are a few things it can do.

Components

nobody wants to reinvent a table, label, or stat widget.

Framework components provide device-aware markup that looks great on your computer screen or ePaper display. charting is powered by Highcharts under the hood, with theme overrides to account for hardware limitations.

speaking of hardware...

Hardware

as our device model library grows, your work should Just Work on different display sizes and resolutions.

the model picker reads from the Model API to inject dimensions, colors, and other capabilities of a given device directly into the web based markup editor or your local dev tooling with trmnlp.

try changing parameters in the top-right dropdown in our docs to see how it works:

Framework is even compatible with televisions, tablets, iPads, and beyond.

Legibility

perfect vision is wasted on the youth. we created our own font from scratch, and now it's yours. for everything else there's Inter.

whether you want small type, large graphics, serifs or sans, Framework lets you scope typography on a per element basis.

Magic (JavaScript)

tying together many of the above elements is a JS runtime, terminalize().

this lets you scale text, adhere to cultural or regional formatting, truncate big values, and more.

Value Formatting

if you're wondering why this matters, it's because TRMNL is designed for arbitrary content. the value of {{ some_variable }} should never break your markup.

Fit Value

the Framework Runtime even solves for fixed display heights, check out Table Overflow.

what's next

if you're just getting started, check out the docs and examples. if you've been with us awhile, skim the v3 overview guide for the latest features.

to report an issue or contribute new features, visit the source code:
https://github.com/usetrmnl/trmnl-framework

Model X Progress Report

2026-08-12T00:00:00+00:00

We introduced X on July 30, 2025. We began assembly + fulfillment on March 18, 2026.

To see your live spot in the order queue, go here:
https://trmnl.com/order-tracker

Here's our per-warehouse queue as of August 18, 2026:

For detailed updates over time, see below.

When will I receive my TRMNL X?

Live in USA, Canada, India, Mexico, or Australia?

Your TRMNL will ship from our USA warehouse. See chronological updates below for the latest availability.

Live in Europe, Asia, Africa, South America, etc?

Your TRMNL will ship from our Berlin warehouse. Due to Customs issues and supplier theft, this warehouse is moving slower through their queue than the USA. See chronological updates below for the latest availability.

Tech Specs

Highlights below, or see everything here.

10.3" 1872x1404 EPD resolution with 16 shades of gray
Dust and basic waterproofing with a hacker-friendly enclosure
ESP32-S3 with 16MB of flash and 8MB of PSRAM as a core processor with fallback 2.4GHz WiFi
5GHz WiFi support via ESP32-C5 as a modem (external antenna)
Support up to 2x 6000mAh 3.8V LiPo batteries with automatic detection
Battery gas gauge from TI for battery SOC/SOH/capacity tracking
Bosch accelerometer for portrait/landscape orientation
Gesture touch-bar based on Azotech IC
Magnetic pogo pin-based mount for charging and accessories (Coming 2026)
OTG support with 5V 2A output

Dimensions

These values may change as we scale production. last updated December 15, 2025.

X enclosure dimensions (mm)

Weight (device only, no attachments)

1 battery - 362 grams
2 batteries - 448 grams

August 2025

Multiple boards and controllers support touch gestures, battery charging, and 5ghz WiFi
The circular area interfaces with a waterproof "puck" shaped charging connector, and several test points on the motherboard's bottom will let us build a QA jig for our warehouse
Prior to release we'll prototypes to your favorite creators for first-look reviews

September 2025

PCB preview

We ordered 50x more prototypes with stronger magnets so devices can attach directly to a surface (e.g. refrigerator) without mounts
Dual band WiFi will be powered by the ESP32-C5 and we've benchmarked faster speeds + better range with custom modem firmware
Orders with the Battery Upgrade (or Clarity Kit) will now enjoy 10,000mAh versus the announced 7,000mAh variant
Our "charging puck" (name TBD) now has a universal connector for kickstands and other peripheral accessories that will debut in 2026
The same firmware that runs all OG + BYOD devices has been extended and is already running my own X prototype, preview here

October 2025

Grayscale testing with a GOAT

The first batch of screens arrived at our USA warehouse, more en route to our Berlin warehouse
Gesture bar + charging pucks are in small batch production
Received and approved packaging samples. Model X packaging will be more premium and protective than OG packaging.
Consolidating WiFi antennas (2.4 + 5gh) to a single component
Added 3 angle options (degrees) to the kickstand
[Work in progress] battery options may grow another 20% to 6000/12000mAh variants pending more testing

November 2025

Full assembly (3D printed parts, not final)

Fully functional prototype (3D printed case, non-branded silicone pads)

Prototype running latest (public) firmware release

Added extra reset buttons to S3 and C5 MCUs for hacker friendliness, board design is final
Batteries are in production and we can confirm the improved 6k / 12kmAh sizing (announced size: 5k / 7k)
Enclosure injection molds are in production, purchase order placed for thousands of cases in different colors
Magnet deliveries from Chinese factories have been delayed due to recent Critical Mineral Export Bans

December 2025

Battery production complete, shipping to our warehouses next week
EC licenses underway at testing facilities
Packaging in mass production
Magnets in mass production
[New] OTG functionality - power other devices from your TRMNL's charging puck

January 2026

From my desk to yours, a video update.

February 2026

From our warehouse to your desk, a video update.

March 2026

From my desk to yours, a video update.

If you prefer not to watch the video, in summary we're shipping single-battery devices only from our USA warehouse because our magnet supplier ripped us off and sent thousands of weak magnets, following multiple sample shipments with the correct (strong) magnets.

As of Wednesday, March 18:

Berlin warehouse has all 3 types of PCBs
Berlin warehouse should receive device enclosures in 1-2 weeks
USA warehouse has everything and has begun assembly + fulfillment

To check your place in the queue go here:
https://trmnl.com/order-tracker

If you already have a TRMNL, install the Order Tracker plugin to stay up to date:
https://trmnl.com/recipes/260817

How can I estimate the time it will take to receive mine?

Devices will be shipped in the order they were purchased and we intend to scale to 100s of fulfillments per day, as we have done for past releases and back-in-stock periods.

Our 2x warehouses have trained 15+ individuals to flash, assemble, and ship devices. We do not outsource to 3rd party logistics companies. You can learn more about our end to end philosophy and technology here and here.

April 2026

See a live demonstration of strong, N52 grade magnets on various refrigerator surfaces in this video update.

On April 26, N52 magnets arrived at our USA warehouse and assembly/fulfillment pace will increase dramatically beginning Monday, April 27.

On April 27, white + gray cases arrived at our Berlin warehouse and they are building half-assemblies (docks, kickstands) as they await N52 magnets.

May 2026

Between May 2-6th the USA warehouse was out of stock of charging docks for several colors due to a supplier mistake. To mitigate we assembled devices of all colors, but only fulfilled in-stock (charging dock) orders, some of which may sequentially be behind yours.

May 7 - black and sage charging docks arrived, allowing us to mostly ship in sequential order. This ensures the highest throughput overall, as punishing later orders with in-stock colors does not increase the speed of out-of-stock colors arriving.

May 19 - USA warehouse is still awaiting white + gray docks and cannot ship those colors, despite having the other parts. They were lost in transit and a new batch is on the way.

May 21 - Berlin, Germany warehouse received a batch of N52 magnets. They are now shipping black, sage, clear.

May 27 - Berlin, Germany warehouse received white u-mounts and is now able to ship white devices.

May 29 - USA warehouse received missing white charging docks and is finally shipping white devices.

May 31 - USA warehouse ran out of Clear enclosures and sage wall mounts. Black running very low. New shipment (full refresh) expected within a week.

June 2026

June 1 - USA warehouse received missing gray charging docks (sent/lost by UPS on April 7).

June 4 - Berlin, Germany warehouse received gray enclosures.

June 5 - Berlin, Germany warehouse received wood enclosures. Berlin is now able to ship all colors.

June 9 - USA warehouse only has inventory to ship white and gray X devices. More of every color arrive Thursday, June 11.

June 11 - USA warehouse received more inventory of every color and is fully in stock, shipping all X combinations.

June 21 - USA warehouse ran out of clear enclosures; affected customers have been emailed the option to change colors and not experience further delays.

June 24 - USA ran out of sage docks + kickstands, as FedEx lost this package (1 of 42 in our latest freight shipment) in May and is still looking for it. An extra set of components has been ordered (via air express) from our injection mold supplier.

Sage components lost by FedEx

June 29 - Berlin, Germany warehouse ran out of branded packaging. A rush order is en route. The team is still assembling devices to minimize delays.

July 2026

July 3 - USA warehouse received missing Sage docks + kickstands, along with Clear cases. Clear kickstands + docks are still en rout, but the remaining 300+ on-hold Sage orders will be shipped by end of Monday, July 6.

July 7 - Berlin, Germany warehouse received X packaging. Foam should arrive within 24 hours and then shipping will resume.

July 13 - Berlin, Germany warehouse continues experiencing delays in receiving X packaging foam. As of today, 3 of 5 pallets have arrived at BER airport and are still processing through Customs. They have been stuck elsewhere in Europe for 7 days.

July 15 - Berlin, Germany warehouse finally received packaging foam and is resuming shipments of assembled devices.

Die-cut packing foam

July 23 - Berlin, Germany is down to their last ~150 devices and awaiting a new shipment of PCBs, ordered on May 6 but with long lead times. USA warehouse is expecting missing Clear kickstands / docks / u-mounts next Monday, then its queue will be zero'd out.

July 27 - Berlin, Germany received new packaging and is expecting more PCBs tomorrow.

July 30 - Berlin, Germany PCBA are stuck in-country but stuck at Customs. A new batch of PCBA were shipped to USA warehouse and should arrive on August 5th.

August 2026

August 3 - Berlin, Germany received a new batch of PCBA following a week of being stuck in Customs. Shipping resumed today. Incoming USA batch of PCBA cleared Customs last night and arrive on Wednesday.

August 12 - USA warehouse PCBA have cleared Customs, then put on hold, back and forth a few times. We got in touch with courier (DHL) and they don't have more information. As of this morning the freight has again "cleared" Customs.

August 18 - I (Ryan) visited the ATL airport cargo facilities to check on our PCBA freight, which continues to post "Clearance" events, followed by "On Hold" notifications, multiple times per day since early August.

Visiting DHL <> Customs

Unfortunately the assigned CBP agent was not in office, so we left our information with a request to expedite clearance. The DHL team claims we will receive a phone call update within 24 hours.

Featured Community Plugin - Jenkins CI/CD

2026-08-11T00:00:00+00:00

This post is part of a series, featuring the incredible work of plugin authors who grow the TRMNL plugin ecosystem with every contribution. The TRMNL team has individually selected these plugins and authors to be featured.

Jenkins CI/CD

Community member Stephen Yeargin (Discord: stephenyeargin) created the Jenkins CI/CD plugin; here are their words on how it was created.

Why did you want this plugin to exist?

I've used Jenkins at various jobs for a rather long time, and decided a few years ago to start using it to orchestrate personal projects. I had a scheduled build fail and didn't get the notification, so I thought it would be nice to keep up with it on the TRMNL near my desk.

Were you inspired by any other recipes or plugin creators?

There are a handful of great plugins that monitor GitHub Actions workflows. I looked through those to understand the different ways to present the data.

How did you balance look vs functionality?

I lean into the Framework components to make most of the harder UI decisions for me so that I can focus more on making sure the data is timely and accurate. I tend to lean into function first, and improve the design through iteration.

What was your process for creating the plugin?

I have a GitHub repository template that I used as the base of it. From there, I read through the REST documentation for Jenkins and tested a few of the calls with Postman. I stuck to the general Job list in Jenkins to decide what was important. The TRMNLP application is indispensable for developing plugins.

What, if any, challenges did you face while creating it?

Jenkins uses weather icons to quickly identify the health of your builds. I needed to find SVG icons for each, and to make sure the logic picked the right one. From there, the next challenge was getting the JSON payload under the limit with the sandbox runtime. I also knew I wanted to let the user see either all jobs, or builds from a specific job, so I needed to work out the logic for that.

Did you learn anything that you want to apply to future or past recipes?

Using conditionals and assignments in the polling_url setting. It makes managing the data flow a bit easier and prevents unnecessary requests.

polling_url: |
  {%- if my_setting_value -%}
  https://example.org/api/endpoint_1?q={ my_setting_value }
  {%- else %}
  https://example.org/api/endpoint_2
  {%- endif %}

Is there a tip you would give to a new plugin developer?

Follow the blog for new features and join the Discord server. Also, shared.liquid is your friend for not repeating a ton of markup for all four views.

What part of the TRMNL Framework, Liquid filters, or other documentation was most helpful?

Table Overflow is really useful to ensure the data fills the screen, but doesn't break the layout.

What is your favorite plugin that someone else created and why?

Paperboy is solid. It immediately reminded me of Freedom Forum's "Today's Front Pages" site, which I had bookmarked from when I worked for a newspaper.

What might you improve about the plugin in the future?

Not everyone has a dozen Jenkins Jobs, so I probably would come up with another view that showed them as cards in a grid.

Creator Fund - July 2026

2026-08-07T00:00:00+00:00

for more context see the Creator Fund announcement.

our 10th payout recognizes community contributions between July 6, 2026 and August 6, 2026.

source of funds

each payout period, a portion of developer-specific revenue goes directly to creators.

source	revenue	share	amount
Stripe Developer Edition BYOD TRMNL+ Shopify Developer Edition Clarity Kit (X) Clarity Kit (OG) BYOD	$4,660 $2,900 $535 $398.73 $12,664.41 $16,977.77 $8,818.39	15% 15% 80% 15% 10% 10% 15%	$699 $435 $428 $59.81 $1,266.44 $1,697.78 $1,322.76
	$46,954.30		$5,908.79

source

revenue

share

amount

Stripe

Developer Edition
BYOD
TRMNL+

Shopify

Developer Edition
Clarity Kit (X)
Clarity Kit (OG)
BYOD

$4,660
$2,900
$535

$398.73
$12,664.41
$16,977.77
$8,818.39

15%
15%
80%

15%
10%
10%
15%

$699
$435
$428

$59.81
$1,266.44
$1,697.78
$1,322.76

$46,954.30

$5,908.79

by the numbers

total payout: $5,908.79
plugin author share: $4,136.15 (70% of base total)
strategic contributors share: $1,772.64 (30% of base total)

plugin author earnouts are calculated automatically by a collection of factors including a plugin's age (on live playlists), presence (by % dominance on playlists), and impressions (times displayed on device), relative to all other community plugins. there is a minimum threshold of 50 total connections (installs + forks) to qualify for monthly payouts.

strategic contributors are those who contribute to TRMNL open source projects. these earnouts are calculated with a mix of automation + human touch. relative to the funding available, below are allocations by category:

Firmware, 25%
3D Models, 0%
BYOS, 66%
Localizations, 2%
BYOD, 5%
Documentation/Resources, 0%
Tooling, 2%

note: these allocations change monthly based on contributions by category.

algorithm?

see the algorithm in action here. over time the above weights, revenue share percentages, and minimum thresholds may change.

candid feedback is welcome, email team@trmnl.com.

Featured Community Plugin - Ham Radio Solar Weather

2026-07-28T00:00:00+00:00

This post is part of a series, featuring the incredible work of plugin authors who grow the TRMNL plugin ecosystem with every contribution. The TRMNL team has individually selected these plugins and authors to be featured.

Ham Radio Solar Weather

Community member Leo Herzog (Discord: leoherzog) created the Ham Radio Solar Weather plugin; here are their words on how it was created.

Why did you want this plugin to exist?

Ham radio (amateur radio) is a hobby where licensed operators talk to each other over the airwaves — sometimes across town, sometimes across the planet — without any internet or cell network involved. Because the Earth is curved, to make the long-distance part work, radio signals must be bounced off the ionosphere and come back down. The ionosphere's "bounciness" changes constantly based on what the sun is doing: solar flares, sunspots, and streams of charged particles can make worldwide contacts easy one day and impossible the next. Hams check "space weather" the way surfers check the surf report. Hams loooooove themselves an old looking, information dense, hard-to-parse web design. I saw TRMNL as a nice opportunity to make the current solar weather conditions pretty and parse-able.

Why were you the person to make it?

I'm a licensed ham (K9ZOG). I don't do a lot of "contesting" (long-range radio contact)... I mostly use my local radio net for severe weather spotting, but it's a hobby I keep an eye on. I'm also a web developer and have already built several TRMNL plugins, including one for National Weather Service severe weather alerts, so I had the muscle memory for how the platform fetches data and renders it. Space weather turned out to be a natural sequel to regular weather: same idea, different layer of the atmosphere. There's a wonderful free current conditions data feed maintained by a fellow ham (N0NBH) that condenses all the solar readings and band-by-band forecasts into a simple XML format, so it was a natural fit.

Were you inspired by any other recipes or plugin creators?

I've kept up with TRMNL since the Kickstarter. I'm an eInk enthusiast, and TRMNL is doing everything right; BYOD, BYOS, open-sourcing everything, their approach to server-side rendering and client polling... I had two other homegrown dashboard projects that used similar approaches, but way clunkier implementations, that I've now discontinued in favor of TRMNL. I'm inspired by that. As far as the design of this plugin specifically, I was inspired by other information-dense-yet-readable-and-pretty dashboards such as Extended Weather Dashboard by Bastronautik.

How did you balance look vs functionality?

I prioritized look for this one. The raw data is a wall of cryptic numbers—solar flux, A-index, K-index, proton flux—and the whole point was to make conditions legible in a half-second glance from across the room. The band conditions table won the prime real estate, because "is 20m open right now?" is the question a ham actually asks; The raw solar numbers became supporting detail for people who want to know why.

What was your process for creating the plugin?

Right before I started making this plugin, TRMNL released their Agent Skill for AI Agents. I threw away my homegrown skill and installed theirs. I described the layout I was imagining, curl'd a local copy of the data XML, described the look layout I wanted and file structure I preferred (minimal template files in the four layouts + everything possible contained in shared.liquid), and within a few back-and-forth prompts in Claude Code, the plugin was done.

Did you learn anything that you want to apply to future or past recipes?

When laying out a TRMNL plugin, remember the root .layout clips instead of scrolling — and crops the top when content overflows — so design to fit the fixed screen rather than forcing height with h--full. Use the real stretch class (not a Tailwind-style min-h--0) when you need an element to grow and shrink into leftover space. Keep grid grid--cols-N as a direct child of .layout; nesting it inside a col--span cell collapses it, so build sub-columns from side-by-side flex flex--col stacks instead — which also align cleaner, since flex--row items with grow center their contents and visually zig-zag.

Make sure your col--span values add up to 12, and know that flex--center-x/flex--center-y are direction-aware (they resolve to justify vs align based on a sibling flex--row/flex--col), so pair them accordingly or centering lands on the wrong axis. Above all, verify that all class names against the actual framework CSS rather than assuming a familiar Tailwind name exists — the design guide shows intent, but the compiled CSS is ground truth.

Is there a tip you would give to a new plugin developer?

Think about things that you glance at often on another device: Smartphone homescreen widget, persistent notification, pinned desktop browser tab, etc. Then, consider if that app/site/data has an API. If you create something you're interested in and fills an actual need, it'll be more fun to make and more useful when complete!

What part of the TRMNL Framework, Liquid filters, or other documentation was most helpful?

The new TRMNL agent skill and published Framework v3.1.1 CSS files, for sure.

What is your favorite plugin that someone else created and why?

I have had a Weatherflow Tempest weather station for a few years, and I love that TRMNL selected them as their main weather provider. I was going to have to build something custom if they hadn't!

How could TRMNL plugin sharing be improved?

The recipe system is already one of TRMNL's best ideas, but right now the catalog is the only path to distribution, which makes the TRMNL team the bottleneck for every niche idea that wants an audience. I'd love to see a model closer to what Home Assistant has with HACS: let a recipe live in any public git repo with a small manifest, and let users install it by pasting a URL. The official catalog stays as the curated, quality-reviewed storefront, but the long tail of weird, wonderful, six-user plugins gets a frictionless path that doesn't require anyone's time or approval.

Fast refresh for $0

2026-07-22T00:00:00+00:00

faster refresh has been a top feature request since Day 1.

because we don't require a subscription, we have to be careful with infrastructure costs. this ensures your devices can use our cloud service forever without paying a penny.

so we drew a line in the sand: a max speed of 15 minutes per plugin. and for most of you this is fine. unless of course you need transit times and meeting room availability... more on this in an upcoming announcement.

anyway, the current fast refresh solution is TRMNL+, a $5 /month subscription launched exactly one year ago. but let's face it, nobody wants to subscribe to anything, ever.

which is why today i'm thrilled to offer a new approach.

introducing TRMNL+ for $0

note i didn't say "free." it's not free. just instead of spending your hard earned cash, how about a little bit of social capital instead?

in exchange for sharing honest feedback, publicly, you can unlock 5 minute refresh rates forever.

get started here:
https://trmnl.com/plus/earn (requires login)

and yes, the $5 /month option is still available.

how it works

share TRMNL
our team confirms
TRMNL+ is activated on your account

no payment method is necessary, you'll never be auto billed, and we can optionally send you a reminder to participate again in the future when your credit expires.

everyone has influence

we don't advertise on Google or Facebook or TikTok or anything like that. sometimes we gift devices to creators, but mostly we exist thanks to word of mouth.

if this deal isn't your jam, no sweat. if we never earn another referral we'll open source our platform. but i hope you'll help us hack on it together for a long, long time to come.

consider sharing TRMNL today.

Featured Community Plugin - RetroWall

2026-07-15T00:00:00+00:00

This post is part of a series, featuring the incredible work of plugin authors who grow the TRMNL plugin ecosystem with every contribution. The TRMNL team has individually selected these plugins and authors to be featured.

RetroWall

Community member JetSharkLambo (Discord: jetsharklambo) created the RetroWall plugin; here are their words on how it was created.

Why did you want this plugin to exist?

My wife likes to get me surprises every now and then, but was always tipping it off by asking me what I was playing. I made Retrowall to share with folks what I'm playing without them having to ask! Now you can just take a look at my TRMNL and see a collage my most recently played games.

Why were you the person to make it?

I'm a huge retro gamer and retroachievements has motivated me to play and replay a lot of classics just for these incentives. Likewise, this plugin has me playing a lot of my faves just so the collage looks perfect around gift-giving season!

Were you inspired by any other recipes or plugin creators?

Big fan of jvdmeij's Paperboy, it really shows you that art is the relevant info that people want sometimes so you need to put it front and center.

How did you balance look vs functionality?

The look was certainly more important for this plugin. We have so many options to alter the look for this reason. For functionality, we just had to make sure the number 1 game rendered somewhere near the center of the grid so that each look you designed was functional.

What was your process for creating the plugin?

It's actually a very simple plugin. Claude code made the first draft in minutes and then we added a ton of customization features on top of that so that each user could have a unique view even if they played the same games. Did some testing to remove some options that were more likely to break your view than enhance it and it was done!

Did you learn anything that you want to apply to future or past recipes?

Design wise: don't waste words on stories that can be told entirely with images. Not every story can be told with images only, but if it can, that's the most efficient way to tell the story.

Is there a tip you would give to a new plugin developer?

Use the visual editor! It shows you all views at the same time so you can diagnose issues that are persisting across multiple views, its great!

What is your favorite plugin that someone else created and why?

Advanced RSS is the first plugin that brought the promise of TRMNL to life. It has dramatically reduced the amount of times I pull out my phone and scroll. I simply walk past my TRMNL when I'm in the kitchen, glance at the latest pull from the RSS's I follow, and rest easy knowing that nothing new has happened since I last checked!

Introducing the Model Builder

2026-07-14T00:00:00+00:00

our BYOD (build your own device) effort is working. over 4,000 licenses now power 100s of hardware combinations.

the first bottleneck in making this possible was embedded software. Raspberry Pis and Android tablets can't run our firmware, and Kindles need their own jailbreak. with the community's help and simple APIs this has since been resolved.

which exposed the 2nd bottleneck: device model specs.

to support a piece of hardware, someone from our team had to look up its screen capabilities, size, and other technical factors, then add it to our database and re-deploy the Models API.

TRMNL engineer Ikraam made this process a lot nicer with a CLI tool:

============================================================
TRMNL Device Model Addition Script
============================================================

Enter device specifications:
  The keyname is a unique snake_case identifier used internally.
  Convention: manufacturer_model 

Keyname: <insert>

but still, it's 2026. who wants to deploy a server to deploy a new feature?

introducing Custom Devices

starting today, anyone with a BYOD license may visit the Device settings > Model picker, set their model to Custom Device, then provide the same details which previously required a server deployment.

DIY model specifications

you also gain access to device agnostic Presentation features including color palettes, font families, image rotation, and screen orientation.

Presentation settings

next steps

we hope this deploy-free option makes it easier + faster to try new hardware, without our permission.

for more information about Device Models generally, read the docs.

Introducing Fluid Mashups

2026-07-13T00:00:00+00:00

one of my hobbies is announcing features requested before we launched the company.

the year was Summer 2024. Claude was just your crazy uncle and Kickstarter still had clout. our campaign attracted 1,000+ early adopters with compelling questions:

what if i want to share my work?
is it possible to remove the screen flicker?
can i see fun stuff only after work hours?
what if i want to split screen the display?

the final boss battle -- dynamic screen-splitting -- required flexible and responsive design elements. so we spent the last 3 years building a design system.

and these 8 static layouts have been good to us.

but it's time for something new: say hello to fluid mashups.

what are fluid mashups?

rather than conform plugins to Procrustean, 25-50% sections of your screen, you may now combine up to 322 different layouts on a 9-slot grid.

want a dashboard that's 2⁄3 weather, 1⁄3 upcoming appointments? no problem.

how about a central calendar, surrounded by photos and dates?

anything is possible with the new fluid mashup builder, available exclusively on TRMNL X and X-sized devices like reMarkable, Kobo Aura One, Boox Nova Air C, and Seeed E1003.

learn more

to see this in action, check out our latest Behind the Screens video where we build this:

to play with an early demo (no account required), go here.

Meta Portal is now TRMNL

2026-07-09T00:00:00+00:00

Meta ended support for 1,000,000+ of their "Portal" devices, a modified Android tablet designed for video calls through Messenger and WhatsApp.

thankfully they announced support for Android Debug Bridge, which lets owners build and share apps, unlocking value from the underlying hardware.

in TRMNL tradition we picked up a used Portal for just $19 (+ shipping) on eBay and made it a personal dashboard. shout out to community member JackR for the suggestion and assistance.

how it works

Meta Portals run Android
the TRMNL community, specifically Hossain Khan, maintains a TRMNL Android app
you can install these apps on a Meta Portal with a USB-C cable, no coding required

get started

the guide below should take no more than 10 minutes.

step 1 - buy a Portal

any model / generation will work, in this post we'll showcase a Gen2, 10" display. if you get something else we may need to adjust the available device models, just send us a live chat or email support@trmnl.com.

step 2 - set up the Portal

go through the normal onboarding, connecting WiFi and logging into either a Facebook or WhatsApp account. you cannot access Settings unless you log into a social network (i know, i know...).

if your device does not arrive in "setup mode," it's easy to perform a factory reset.

step 3 - enable Android Debug Bridge

from your Portal's home screen, navigate to the Apps tab, then tap the Settings icon, scroll to the Debug section, and tap again to Enable ADB.

you will likely be asked to provide your 4-digit pin from Step 1.

step 4 - connect the Portal to your computer

plug a USB-C cable into your Meta Portal. i spent 10 minutes finding my port on the Gen2 -- it's behind the speaker. each Portal is different.

credit: r/FacebookPortal

you should see a prompt on your Portal, asking you to "Allow USB debugging." tap to allow. if you don't see this prompt, or it disappears, or you accidentally hit cancel, just turn off your Meta Portal (disconnect power), remove the USB-C cable, and plug it back in + try again from Step 3.

step 5 - install Android Platform Tools

if you're on a Mac and you regularly write code, you may have Homebrew installed, in which case you can brew install --cask android-platform-tools .

if you're not on Mac, or you do not use Homebrew, download the dev tools here under Downloads:
https://developer.android.com/tools/releases/platform-tools

this is a relatively small (16mb) zip file. double click to expand it on your computer and you should see a short list of executable files inside:

step 6 - download the TRMNL android app

TRMNL has a couple Android apps developed by community member Hossain Khan. one is for turning a tablet into a device, the other is for managing multiple devices. we want the first app called TRMNL Display.

download the latest release's "APK" file, which is a bundle of the TRMNL Display application, here:
https://github.com/usetrmnl/trmnl-android/releases

at the time of writing i'm downloading the file called "trmnl-v2.11.0.apk" from the v2.11.0 release.

TRMNL Display - APK file

step 7 - install TRMNL on Meta Portal

it's time to open up a terminal (console) on your computer. if you're on Mac, hit cmd+space and search for "terminal," then hit enter.

if you installed the Android Platform Tools via Homebrew...

navigate to wherever you downloaded the APK file (e.g. cd ~/Downloads)
run adb install trmnl-v2.11.0.apk

if you installed the Android Platform Tools by downloading the zip file...

navigate to wherever you un-zipped the "platform-tools" folder (see picture in Step 5)
copy or move the trmnl-v2.11.0.apk file you downloaded to the same folder
open your terminal/console and navigate to that folder (containing APK + executable files)
run ./adb install trmnl-v2.11.0.apk

you should see output like this:

Ryans-Mac-mini:Downloads ryanckulp$ adb install trmnl-v2.11.0.apk 
Performing Streamed Install
Success

see Troubleshooting below if you don't get a success message.

when the installation succeeds, your Meta Portal will go black for a brief moment, then blink back on. from the Apps tab you should see TRMNL installed.

TRMNL display on Meta Portal

tap to open the app, then set it up as a regular TRMNL or BYOD device (free trial, then $50 lifetime license), pending your preferences.

you may also point your Meta Portal to a self-hosted server for a completely free experience. simply select BYOS from the TRMNL app home screen and follow along the instructions.

step 8 - enjoy

there's no reason 1 million Meta Portals need to visit a landfill. for $0-50 you can bring it back to life with TRMNL.

Art of the Day + Meta Portal

(full color also supported, just change your Presentation from the device settings tab)

troubleshooting

while installing the TRMNL Display Android app, if you get a failure message, it's possible you didn't yet enable the Debug tools. additionally, any time you restart a Portal the ADB debugger is disabled. repeat Step 4 to be sure.

to confirm your device is detected by your computer, run adb devices (or ./adb devices if using the zip folder contents) to confirm it appears:

Ryans-Mac-mini:Downloads ryanckulp$ adb devices
List of devices attached
819LCM01Z0944N04 device

to go back to your Meta Portal's home screen or use other apps, swipe "up" from the bottom, then tap the power off button. this will not actually turn off your Portal, it will just shut down the TRMNL Display app.

Turn off TRMNL Display