Skip to main content

Getting to Know your TRMNL X's Touchbar

Interact with your fingertips on the bottom of the TRMNL X, below the screen, using the touchbar.

Written by David

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!

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 Screens

  • Enter 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 Mode

  • Turn 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 X

  • Special 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.... The last two ask you to confirm, with the arrow starting on Back.

  • 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

Did this answer your question?