TRMNL X is our larger ePaper display, with a 10.3 inch screen that shows 16 shades of gray, a touchbar below the screen, and the freedom to hang it in portrait or landscape. This page covers what makes the X different and points you to the right article for each topic.
Everything you already know from the TRMNL OG still applies, because you add plugins, build playlists and change settings in the same web app as before. The differences live in the hardware, the screen and a handful of device settings.
At a glance
Screen. 10.3 inch ePaper at 1872 x 1404 pixels and 227 PPI.
Grays. 16 shades of gray (4-bit), where the OG shows black and white or 4 grays.
Controls. A touchbar along the bottom edge, below the screen.
Orientation. Landscape by default, portrait whenever you choose it.
Wi-Fi. 2.4 GHz and 5 GHz.
Battery. 6000 mAh, or 12000 mAh with the battery upgrade, charged over USB-C through a magnetic dock.
Mounting. Kickstand, wall mount or the built-in magnets.
For the nerds, the full list lives on the TRMNL X spec sheet.
Setting it up
Start by attaching the round charging dock to the back of the X, which is magnetic and snaps into place on its own. Plug a USB-C cable into the dock and the other end into power, and the device should boot within a few seconds. If nothing happens, rotate the dock 45 degrees and give it a few more seconds.
From there, connect to the "TRMNL" Wi-Fi network from your phone, enter your home network, and register the 6 digit Friendly ID on your account. How to set up a new device walks through each screen and has a section dedicated to the X.
The touchbar
Instead of a button on the back, the X has a touchbar along the bottom edge that is split into three zones: left, middle and right. Firmware 1.8.18 changes what they do, and devices move to it over the coming weeks. To see which firmware you have, look for Current firmware under Device Info in your device settings.
Next screen. On firmware 1.8.18 and later, tap the middle to open the menu, then choose Next Screen. On earlier firmware, tap the middle.
Back and forward. Tap the left or right zone to page through recent screens.
Wi-Fi pairing mode. On 1.8.18 and later, choose Settings..., then Reset Wi-Fi... in the menu. On earlier firmware, hold both ends.
Turn it off. On 1.8.18 and later, choose Settings..., then Shut Down... in the menu. On earlier firmware, enter Wi-Fi pairing mode, then hold both ends and hold the middle to confirm.
When you touch the bar, the screen shows where your finger landed, so you know what the X thought you did. On firmware 1.8.18 and later, a touch on the left or right draws an arrow. On earlier firmware the screen fades and draws a box: a white box means a short press and a black box means a hold. Getting to Know your TRMNL X's Touchbar has the details, including the menu on 1.8.18 and how to change tap to swipe on earlier firmware.
Portrait and landscape
The X shows landscape by default. To turn it on its side, open your device settings, go to Presentation, set Screen Rotation to Portrait and save, and the screen becomes 1404 pixels wide and 1872 pixels tall.
Your playlist won't flip all at once, because each plugin draws a new portrait screen at its next refresh. For private plugins and installed recipes you can speed this up with Force Refresh on the plugin settings page, and Portrait mode covers the rest.
Grays and color palettes
The X has three color palettes to choose from: 16 Grays (4-bit), 4 Grays (2-bit) and Black & White (1-bit), and a new X starts on 16 Grays. More grays make photos and charts look their best, while fewer grays mean smaller images, faster screen changes and longer battery life, so the right pick depends on what you show.
You set the palette for the whole device in device settings, and you can override it for any single playlist item. Understanding Color Palettes explains the trade-offs in more depth.
Battery and charging
The X runs on one or two 6000 mAh batteries. Each time it wakes up it reports its battery voltage, and we turn that into the percent on your device's battery settings page using a discharge curve measured on real X devices.
The low battery email is on by default for a new X, and we send it when the charge drops below 15% and the X is not charging. After each email we wait longer before the next one: 1 day, then 2, 4, 8 and so on, starting over once the battery is back to 50%. If you'd rather not hear from us, turn off Low Battery Email Notification on that same page, or send it to another address with Send This Device's Notification To.
How long a charge lasts depends on your refresh rate and palette, and charging times for each battery size are in the Device battery FAQ. If you're storing or shipping the X, turn it off first.
Plugins on the X
Existing plugins work on the X without any changes, because the X lays each plugin out at 1040 x 780 and then scales it up 1.8 times to fill the screen.
If you build plugins, the TRMNL X guide in our framework docs covers the larger sizes, portrait layouts and 4-bit grays. Community recipes published since January 17, 2026 must support portrait, and the Grayscale article lists the gray classes for each bit depth.
No X yet? With a BYOD license you can pick TRMNL X as the device model and test your plugin at its size before you ever hold one.
Troubleshooting
Not sure what is wrong?
Our troubleshooter walks you through the fix in a couple of minutes.
The X is not broadcasting the TRMNL network?
Some early units shipped with firmware 1.7.5, so update the firmware first. See TRMNL X Not Broadcasting TRMNL Network.
Portrait is set, but a plugin still shows landscape?
Force Refresh the plugin, then save the orientation again. See TRMNL X in Portrait Mode Shows Landscape Screen.
The bottom third of the screen shows noisy squares?
This was a firmware bug that we fixed in v1.8.15, so update your firmware. See TRMNL X image is corrupted over one-third of the screen.
A hold registers as a tap, or a press fires too early?
The touchbar needs recalibrating, and a soft reboot takes care of it. The touchbar article above has more.
Nothing happens when you plug in the dock?
Rotate the dock 45 degrees on the back of the X and wait a few seconds.
Related


