Your TRMNL X has a touch-sensitive bar running along the bottom edge, just beneath the screen. It's so perfectly hidden, some people don't realize it's there at all! Below is the touchbar tutorial with v1.8.18+.
Where it is and how it's laid out
The touchbar spans the bottom edge of the device and is split into three zones: left, middle, and right. Each zone does something different, and you interact with it by tapping (the default) or swiping. You can change that behavior in the Controls section of your device settings.
Firmware 1.8.18 changes how the touchbar works, and devices move to it over the coming weeks. To see which version you have, open your device settings and look for Current firmware under Device Info. On 1.8.18 and later the touchbar no longer supports swiping, so the setting goes away.
What you can do with it
Change screens
Use the left and right zones to page back and forward through recent screens. On firmware 1.8.18 and later, tap the middle to open the menu and choose Next Screen to skip ahead. On earlier firmware, tap the middle to skip ahead. Read more here: How to Change ScreensEnter Wi-Fi pairing mode
On firmware 1.8.18 and later, open the menu and choose Settings..., then Reset Wi-Fi.... On earlier firmware, hold both ends, as explained here: Enable Wi-Fi Pairing ModeTurn the device off
On firmware 1.8.18 and later, open the menu and choose Settings..., then Shut Down.... On earlier firmware, enter Wi-Fi pairing mode first, then hold both ends and hold the middle to confirm, as we show in this article: Turning off the TRMNL XSpecial functions
On firmware 1.8.18 and later, open the menu and choose Special.... Earlier firmware has no special functions on the X. More here: Special Functions
The menu (firmware 1.8.18 and later)
Tap the middle of the touchbar to open the menu. While it is open, the touchbar moves an arrow: tap left to move it up, tap right to move it down, and tap the middle to choose the item it points at. The menu closes by itself after 15 seconds without a touch (60 seconds on the Diagnostics screen).
Next Screen fetches the next screen in your playlist.
Previous Screen goes back one saved screen.
Touchbar Tutorial shows the tutorial again.
Special... lists Identify, Restart Playlist, Send to Me and Guest Mode.
Settings... holds Diagnostics..., Reset Wi-Fi... and Shut Down.... All except Diagnostics ask you to confirm.
v1.8.19 introduced Lock Touchbar.Close closes the menu.
On 1.8.18, until you finish the touchbar tutorial, any touch opens it instead of doing what you tapped. Tap left, then center, then right, then tap anywhere to finish it.
On-Screen Feedback
On firmware 1.8.18 and later, a touch on the left or right draws a black arrow pointing that way, and a tap in the middle opens the menu.
The boxes and icons below are what earlier firmware shows.
When activating left, right, or center of the touchbar, the screen will fade slightly and a rectangle icon will appear denoting the region that was touched.
A white box represents a short press
A black box represents a hold/long press
Additionally, if pressing the middle button, additional icons are present:
Rectangle in the middle representing the touch
Battery charge indicator in the bottom-left (with lightning bolt if currently charging)
TRMNL icon in the bottom right, showing it is communicating with the server to fetch a new screen
If the touchbar feels off
If a long-press triggers instantly, or a hold gets treated like a quick tap, the touchbar likely needs recalibrating. This is quick to fix with a soft reboot, read more here: Recalibrating the touchbar
Something else wrong with your TRMNL X? Our troubleshooter walks you through the fix in a couple of minutes.
Related






