2
5
Fork
You've already forked tangarine
1
9-button faceplate for Tangara
  • Lua 100%
2026年04月29日 09:01:03 -07:00
fab dfm pass: drop SOV-168 for being too weird compared to other switches; allow either SOT-23 or SOT-323 transistors 2025年04月09日 20:25:35 -04:00
images guess these labels don't make sense anymore? 2025年03月09日 18:30:09 -04:00
pcb dfm pass: drop SOV-168 for being too weird compared to other switches; allow either SOT-23 or SOT-323 transistors 2025年04月09日 20:25:35 -04:00
bringup-test.lua updates for mainline firmware 2026年04月29日 09:01:03 -07:00
buttons.FCStd make geometry less actively printer-hostile 2025年02月25日 23:17:15 -05:00
input.lua update input.lua for lua i2c api changes 2025年10月27日 02:52:44 -04:00
LICENSE hello world 2025年01月29日 21:11:29 -05:00
README.md updates for mainline firmware 2026年04月29日 09:01:03 -07:00

Tangarine: a button faceplate for Tangara

Tangarine is a faceplate for the Tangara music player which replaces its touchwheel with a set of buttons. It is designed to fit the touchwheel hole in the stock case, so you don't have to replace it.

photo of a tangara with a tangarine faceplate

BOM

Quantity Part Notes
1 button overlay 3D print one of fab/buttons-v2-blank.3mf, fab/buttons-v2-inset-symbols.3mf fab/buttons-v2-raised-symbols.3mf in a flexible plastic.
1 button frame 3D print fab/buttons-v2-frame.3mf in a rigid plastic.
1 PCB Upload tangarine.zip to your favorite PCB fab.
1 LCD Same as the stock Tangara. See cool tech zone's sourcing recommendations, or reuse one from a stock faceplate if you have the ability to desolder it.
9 Recommended: RKC2SJx170
Also supported: TSA007x15, SKTHACE010, anything else with a similar footprint
Like mechanical keyboards, Tangarine supports getting way too into switches and critiquing them like fancy tea or wine. For best results, say things like "switchfeel" and "notes of clickiness".
10 10KΩ resistor, 0603
1 1MΩ resistor, 0603
1 2N7002 or equivalent, SOT-23 or SOT-323/SC-70 Either will work; sometimes one is easier to source than the other.
1 22μF capacitor, 1206
1 1μF capacitor, 0603
1 TCA9535PW or PCA9535PW, TSSOP-24 No functional differences for how Tangarine uses it; use whichever one you think is a cooler looking letter.
1 GT-F0509SR15-15SMT01 FFC connector to mainboard

Firmware

You'll need at least version 2.0.0 of the Tangara firmware to enable custom input devices.

Once you've flashed that, copy input.lua to the root of your SD card. You can customize the button mapping by editing button_map in this script.

Questions

Why is it called Tangarine?

Because it looks like a sliced-open tangerine, possibly in an odd color.