Congrats on receiving your TRMNL! We're stoked to have you.
When you take the device out of the box, it may already have content on the screen. This does not* mean the device is turned on -- e-ink is cool like that.
Step 1 - Turn on TRMNL
Flip the power switch to ON from the back of your TRMNL device. After it wakes up and blinks a few times, your screen might look something like this:
If nothing happens when you turn on the device, the battery may be drained. In this case, plug TRMNL in with the included USB-C cable (if part of your order) and restart your device using the OFF/ON switch on the back.
Step 2 - Connect to WiFi
As the device screen says, use your phone or a nearby computer to find and connect to the WiFi network named "TRMNL," which will broadcast from your turned on device.
After connecting, a WiFi portal will appear like the middle screenshot above.
Wait a moment while TRMNL scans for available networks, or provide credentials into the SSID/Password box directly if your home/office network doesn't appear or is hidden. Finally, click Connect to share these credentials with your TRMNL device.
(Your WiFi credentials are never sent to our servers)
Troubleshooting
WiFi portal closing unexpectedly? On your phone or computer, click "forget network" (or similar feature), then restart your device and re-connect to TRMNL WiFi.
Sometimes simply turning your device off + on again really does help! But you have to leave the device off for 5-6 seconds, so that our buffer can reset.
Wifi network not listed? Like many IoT devices, TRMNL requires a 2.4ghz network. If you only have 5ghz enabled on your router, you can usually enable dual band with no changes required for your existing devices. It's best to have a separate, dedicated 2.4ghz network versus a "dual band" network.
Getting "wifi not connected" or "content malformed" errors? If you have ad blockers installed at the router-level, try whitelisting the domain "https://trmnl.app". This is the endpoint where the device firmware fetches new content.
Ubiquiti / Unifi customer? Our friends at HostiFi wrote this article with tips to ensure iOT devices like TRMNL play nicely with your network. Without a proper setup, your router's default feature "Band Steering" will direct TRMNL devices to leverage the 5ghz band which will not work, even if you connected to 2.4ghz during setup. If you've already done the above steps, try setting your router's "Minimum Data Rate Control" setting to a minimum of 12mbps on the 2.4ghz network.
If you're using an iPhone > Personal HotSpot, make sure to toggle on "Maximize Compatibility" (beneath your editable WiFi Password field)
Step 3 - Register your Device
After adding your WiFi credentials, TRMNL will restart and show a setup message.
If you don't have a TRMNL account yet (different from your online shopping profile), register at https://usetrmnl.com/signup. You'll be asked for a Device ID, and in this input box provide the ID from your TRMNL's screen.
If you already have a TRMNL account, select Add New from the top-right dropdown picker while logged in.
Step 4 - Connect Plugins
From the TRMNL website, visit the Plugins directory and start connecting data you'd like to show on your device. After your first plugin is connected, you're ready to rock.
Simply restart your device by toggling it OFF/ON, or click the small button beneath the power switch to force refresh your display. This tells TRMNL to request content from our web application.
You can also set up a special function, which is triggered by double clicking the button on the back of your TRMNL device.
Step 5 - Enjoy!
TRMNL keeps you focused but informed, aware but not distracted, and in sync, async.
Feel free to modify the refresh rate, enable sleep mode, and more from the Devices > Edit page in your TRMNL account.
If you have questions about the setup process, email us at [email protected].