Treble keyboard is a 42 key, low profile choc v1, monoblock, moderate column staggered, wireless/wired mechanical keyboard powered by pro micro compatible MCU board. It is designed with ergogen, the ergonomic keyboard generator.
The sandwich PCB design concept came from Horizon keyboard. Bottom plate cutouts for through-hole pins makes it so that keyboard can be put on any surface, and the cover plate hides all the other internal components. Overall, this design makes the keyboard clean, low profile and look more finished without needing a dedicated case.
- Rectangular design for improved stability; easier to place on your lap or a laptop
- Low profile: total height is about 15mm tall
- Compact: overall size smaller than Apple Magic Keyboard
- Column staggered: mildly staggered so it's easy transition from row staggered keyboard yet it provides more comfortable typing experience
- 6 thumb keys: enough thumb keys for switching to different layers
- PCBs-for-case design
- Wireless/Wired depending on your preference
| Part | Quantity | Notes |
|---|---|---|
| Main PCB | 1 | treble_vx.x.zip |
| Cover plate PCB | 1 | treble_vx.x_cover_plate.zip |
| Bottom plate PCB | 1 | treble_vx.x_bottom_plate.zip |
| MCU board | 1 | Pro Micro compatible board |
| Machine Sockets | 2 | Mill-Max 310 |
| Machine Socket Pins | 24 | Mill-Max 3320 |
| Key switches | 42 | Choc v1 |
| Keycaps | 42 | Choc v1 compatible |
| Diodes | 42 | 1N4148 SOD-123 |
| Reset switch | 1 | EVQPU |
| Power switch | 1 | MSK-12C02 |
| JST connector (female) | 1 | S2B-PH-K-S |
| JST connector (male) | 1 | |
| Battery | 1 | 301230 110mAh 3.7V LiPo |
| M2 6mm screws | 12 | |
| M2 nuts | 4 | |
| M2 8mm standoffs (female-female) | 4 | |
| Rubber feet | 6 |
- Male JST connector is only needed if the battery doesn't come with it
- You don't need Power switch, JST connector, and Battery if you build a wired keyboard
Download Treble-A4.pdf and print it (scale at 100%). Test the keyboard layout with your own hands.
- Download gerber files from Releases on sidebar
- Submit gerber files to PCB manufacturer
- Select manufacturing options
- Order
Most options are default. Changed options in italic:
- Base Material: FR-4
- Layers: 2
- Dimensions: (automatically filled in)
- PCB Qty: 5
- Product Type: Industrial/Consumer electronics
- Different Design: 1
- Delivery Format: Single PCB
- PCB Thickness: 1.6
- PCB Color: Black
- Silkscreen: White
- Surface Finish: LeadFree HASL
- Outer Copper Weight: 1 oz
- Via Covering: Tented
- Min via hole size/diameter: 0.3mm/(0.4/0.45mm)
- Board Outline Tolerance: ±0.2mm(Regular)
- Confirm Production file: No
- Mark on PCB: Remove Mark
- Electrical Test: Flying Probe Fully Test
- Gold Fingers: No
- Castellated Holes: No
- Edge Plating: No
I recommend LeadFree HASL option because you will be handling the keyboard directly without a case. Pick the PCB color of your choice. Remove Mark so you won't see random number printed on the PCB.
- Setup GitHub Repo by following ZMK documentation
- Setup User Config by following ZMK documentation
- Copy & Paste
/boards,/config, andbuild.yamlfrom zmk-config folder in this repo to zmk-config folder in your repo - Customise
treble.keymapandtreble.conffiles in/confighowever you like it. Then push changes to your repo
git add .
git commit -m "commit message"
git push -u origin main
- Install firmware by following ZMK documentation
- If you use MCU board other than nice!nano v2, then you will have to edit
build.yamlfile. - Precompiled firmware is also available.
- Check out my personal zmk-config to see how I configured my keymap.
- There's video guide by Joe Scotto if you would rather setup from scratch.
Since the keyboard is pro micro compatible it should be able to run QMK & KMK as well (not tested).
Follow Build Guide to assemble the keyboard.
For any issues or questions please let me know.
If you have built and enjoyed the keyboard, consider supporting me.
Future development ideas:
- QMK & KMK firmware
- Hot swap switch support
- Low profile case
- MX version
