HandShakeTec

T-Embed configuration help

Built: 2026-10-22 17:09:41 BST

The T-Embed Configuration page lets you choose what your T-Embed receiver does, then builds a custom firmware file (the program that runs on the device) for you to download and put onto the T-Embed. The T-Embed is the small receiver unit that sits plugged into your computer or other device and passes on the signal sent by the watch — see the Getting Started and Using HandShake pages if you’re not sure which device is which.

The options that you can set include:

  • Whether the T-Embed plays a sound each time it gets a shake signal from the watch.
  • Whether the T-Embed sends a keystroke to whatever it’s plugged into each time it gets a shake signal from the watch.
  • Which key it sends: a, b, Enter or Space. The T-Embed sends a unless you choose another. Switch-access software often expects Space or Enter, so check what yours uses.
  • Which watch the T-Embed should listen to.

You don’t need any programming knowledge — just work through the page from top to bottom.

How it works: Each time you change an option on this page, that choice is written to a configuration file for your session. When you create the firmware at the bottom of the page, this configuration file is read and used to build the firmware. So, you can go back and change your selections as many times as you want before you generate the firmware.

If the option you’re setting has a ‘submit’ button, the value you enter isn’t written to the configuration file until you click that button. The two on/off switches (Audio and Keyboard) save themselves the moment you click them — there’s no separate submit button for those.

Using the T-Embed configuration website

Using this website you will configure and download a file for your T-Embed which will be called e.g.

zeuss-tembed-firmware.bin

You are free to rename the file after you download it.

The Greek god’s name at the start of the filename will probably be different from the example and will change each time that you restart the configuration page. See below for details of why this is done.

Step 1 — Check your session name

At the top of the page you’ll see your session name. This is a name of a Greek god.

Each time you re-open the configuration page, you will be assigned a new session name. This is done so that the firmware you build doesn’t get mixed up with anyone else’s. The names are taken randomly from a pool of Greek god names. When you next use the site you will probably get a different session name.

The firmware filename produced by the website contains the session name, e.g. zeuss-tembed-firmware.bin, so that you get the firmware for your device and not somebody else’s, even if several people are using the site at the same time.

You’re free to rename the firmware after you’ve downloaded it to your own device. Renaming the file won’t change how it works, so long as you keep ‘.bin’ at the end of the filename. The ‘.bin’ ending is required so that the flashing tool recognises the file as a firmware file.

If the session name is ‘undefined’ then there is a problem with the website! Try again in 10 minutes, or let me know and I’ll get it fixed.

Step 2 — Turn “Audio on shake” on or off

Under Audio Control, the toggle switch controls whether the T-Embed plays a short sound — a click, like a stick being tapped — whenever it receives a shake signal from the paired watch. This gives you, or whoever is nearby, an audible confirmation that a shake has been picked up, separate from anything that happens on the connected device.

With this switched on, you also get the same sound when you double-click the T-Embed’s button to test the switch, which is useful when you’re setting things up.

Click the switch to turn it on (it turns green) or off. There’s no submit button to click — the setting is saved as soon as you click the switch.

Step 3 — Turn “Keyboard on shake” on or off

Under Keyboard Control, the toggle switch controls whether the T-Embed acts as a USB keyboard plugged into whatever it’s connected to (a computer, tablet, or other device that accepts a USB keyboard). When this is switched on, each time the T-Embed receives a shake signal from the paired watch it types a single letter — the letter a — into that device. The first shake after the T-Embed is plugged in types its letter about half a second late: see The first shake after plugging in the receiver.

This matters when you set up your communication software: whatever you want the shake to do, set it to be triggered by the a key.

Click the switch to turn it on or off. As with Audio Control, this saves immediately — there’s no separate submit button.

You can turn both Audio Control and Keyboard Control on together, or use just one of them, depending on what you need.

Step 4 — Enter the T-Watch’s MAC address

Under Enter MAC Address for the Paired T-Watch, type in the MAC address of the T-Watch S3 that this T-Embed should listen to. This is what pairs the two devices together, so that your T-Embed only reacts to your own watch and ignores anybody else’s.

You can type the address either with colons (e.g. AA:BB:CC:DD:EE:FF) or without them (e.g. AABBCCDDEEFF) — either format is accepted.

If you don’t already know your watch’s MAC address, see the Finding the MAC address of your module page for step-by-step instructions on reading it off the watch using a free website called ESPConnect. Make sure you read the address from the watch, not the T-Embed — it’s easy to mix the two devices up when you have both plugged in.

Once you’ve typed in the address, click Submit MAC. A message will appear confirming it’s been saved. If you see a warning about an invalid address instead, double-check you’ve copied it correctly — the tips on the MAC identification page about characters that look alike (0/O, 1/I/L, 8/B) are worth a look if you’re stuck.

Step 5 — Generate the firmware

Beside the button is the firmware version the build will produce, for example Firmware version 2026-10-09b. It is the same date the T-Embed shows on its start-up screen once flashed and its what’s changed link goes to the T-Embed’s list on the Firmware changes page.

Once you’ve set the options above the way you want them, click Generate Firmware. The site reads your choices and builds the firmware file. This usually takes a minute or two and you’ll see progress messages while it works, so please be patient.

The build carries on if you leave the page. Come back to this page and you’ll see its progress, or its result if it has finished.

Step 6 — Download the firmware

While the build runs, the download button shows Building…. Once the build finishes, a download option appears. Click it to save the firmware file to your computer.

Once it’s downloaded, the firmware is yours forever! You own it. No time limits, no subscriptions. All yours.

To put this firmware onto your T-Embed, see the Device Flasher help page for step-by-step instructions.

Comments

Comments are public. Please don't name anyone who uses HandShake, or say that someone took part in our research, unless it is you and you are happy for everyone to read it. You can comment with just a name, or sign in with GitHub. Our privacy notice explains what is stored.