A set of tools and tips to make Twiddler’s “Untethered Re-Chording” mode more useable.
TWIDDLER.KEY:: An example of the TWIDDLER.KEY file you would see on your device.test.org:: Empty Org Mode file to test the scripts withtwiddler-read-dotkey:: HID binary to ASCII converter, as NodeJS scripttwiddler-dotkey-org-inbox-and-clear:: Send TWIDDLER.KEY contents to Emacs Org Mode file, as simple Bash script
twiddler-read-dotkey will require NodeJS to be installed. So far, I’ve tried to make it very backwards-compatible.
twiddler-dotkey-org-inbox-and-clear is a generic shell script, using Bash. You will need to edit the “Configuration” section of the Bash file to point to your own locations and adjust the Org headline to your liking.
- If you’re not sure if you’re in untethered mode, hit N+S OOMO again, you should see blinking, as it tries to connect to bluetooth, then hit the chord again and you’ll know.
- Use an Org Mode shell link to run the script quickly from your agenda. Mine looks like this
[[shell:/home/user/twiddler-headless/twiddler-dotkey-org-inbox-and-clear][Twiddler Untethered -> Org]]. I useC-c C-o (org-open-at-point)to run this once I plug in my Twiddler. - There’s no reason not to run this automatically via
udevorinotifybut I have not been able to make this work yet. If you do have success, please share.
On the TekGear (Twiddler manufacturer) forums, I learned about this mode and about the tool Trout. Unfortunately Trout doesn’t seem to work on Linux, and there was no source code. Luckily the format of the TWIDDLER.KEY file is very straight-forward. It’s just two bytes for every keypress, representing HID codes. A couple hours later I had the start of this tool.
Free as in beer. Do what you want. If you make anything interesting, I’d love to hear about it.