Splinter keyboard

A 62-key split columnar ergonomic keyboard

• andornaut@github /til
  • 3D Printing
  • Electronics
  • Keyboards
• Splinter qmk_firmware

Versions

Version	Description	Layout
v1	61-keys. Asymetrical enclosures. Traditional layout.
v2	62-keys. Symmetrical enclosures. Non-traditional placement of backspace and backslash keys.

Installation

• Ergogen
  • Footprints by ceoloide
  • Footprints by infused-kim
  • Footprints by sboysel
  • Helper scripts
• KiCad
  • KiKit automation tools
• OrcaSlicer

# Include submodules when cloning
git clone --recursive git@github.com:andornaut/splinter-keyboard.git
cd splinter-keyboard

# Install dependencies, including Ergogen
nvm use
npm install

# Install KiCad
sudo add-apt-repository ppa:kicad/kicad-8.0-releases
sudo apt install kicad

# Install KiKit
# Must use the same Python interpreter as KiCad (will not work in a venv)
sudo pip install kikit --break-system-packages

# Update submodules
git submodule update --recursive --remote

Alternatively, you can install OrcaSlicer and Kicad using these Ansible tasks.

Developing

1. Set the VERSION environment variable in .env to one of "v1" or "v2"
2. Prototype a keyboard layout using Keyboard Layout Editor
3. Convert the prototype to a production-ready design using Ergogen
4. Design the PCBs using KiCad
   • Print the PCBs using JLCPCB, OSH Park, or PCBWay
5. Model a case using OnShape
6. Print the case using OrcaSlicer
7. Install the custom QMK firmware

Fix error when running npm run build

The pcbnew Python library, which is packaged with Kicad, may fail if it cannot find libTKBO, eg.:

$ python3
Python 3.12.3 (main, Apr 10 2024, 05:33:47) [GCC 13.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import pcbnew
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python3/dist-packages/pcbnew.py", line 12, in <module>
    import _pcbnew
ImportError: libTKBO.so.7: cannot open shared object file: No such file or directory

Workaround this issue by installing the missing library:

sudo apt install libocct-modeling-algorithms-7.6t64