A Friendly ID is a unique code that identifies your device. Think of it as your TRMNL's personal name. It's what connects your hardware to your account, your playlists, and your plugins. Please don’t share it with others, as it uniquely links to your device.
Why do we call it "friendly"? Because it's made for humans. Instead of a long string of numbers or a hard-to-read MAC address, the Friendly ID is simple and recognizable.
Depending on what device you have, there are different ways to get to your Friendly ID:
If you have a TRMNL DIY kit, an e1001/1002 by Seed or any other BYOD device:
You will need to buy a BYOD license to use usetrmnl.com as your server for your device. After purchase, claim your device by entering your TRMNL order number for the BYOD license. This will give you the device's Friendly ID. Afterwards, follow the steps on this page in section "OSS + closed source approach".
If you’ve ordered the Developer Edition or Clarity Kit
You can start exploring before your device even arrives: create playlists, select plugins, and more. Just go to Claim a device and enter your TRMNL order number along with either your email address or your first name. This will generate your Friendly ID, which you can then use to sign up here.
If you already have a TRMNL device (shipped by us, no BYOD)
Once our own hardware connects to you Wi-Fi, it will display your Friendly ID directly on the screen.
Alternatively
If you've unpaired your device, visit Find my device. Enter your device’s MAC address or serial number, and you’ll get your Friendly ID right away.
And if you've lost your Friendly ID, just reach out to support@usetrmnl.com so we can get you started.