User Manual: Keyball

 Keyball series is designed by Yowkees. The user manual is compatible for 61, 44, and 39. Wireless zmk please visit to zmk-config-Keyball61, and zmk-config-Keyball44.

TL;DR

  1. Use a USB-A to Type-C or Type-C to Type-C cable to connect your keyboard to your PC.
  2. USB-C to right only.
  3. Never unplug or plug-in the Type C or TRS cable while the USB-C connection is still active. Doing so can cause issues. Some people experience problems even after making this mistake once, so be cautious.
  4. Use VIAL to remap the key, NOT VIA.
  5. Layer 3 trackball scroll (version before 1.01). Layer 2 snipping (version 1.01 and above), cursor moves super slow so we can deal with precision pointing.
  6. Insert your switches directly into your board, starting from the four corners. Hold the switch plate or adjust it so that it clips to the top of the switch. If your build comes with a thin 3D switch plate and the method above doesn’t work, you may need to disassemble the screw on top and insert the switch.

How to properly setup / connect your split keyboard

  1. First, connect the left and right halves of your keyboard using the TRS/TRRS cable. Ensure that the cable is fully inserted but not forced violently.
  2. Insert a USB-C (or Type-C) cable into the right side of your split keyboard.
  3. Note that you don’t need to insert a USB-C cable into both sides; only the right side requires it.
  4. Demo video.

 

Key remap

  1. Use Vial to remap the keys. You can download the software or use web interface to remap the keys. You may refer to Basic Vial Usage and Keymap Idea to explore Vial and keymap. VIAL, not VIA.
  2. Auto-detected in Vial, supports Win, Linux, and Mac. Real-time key remap software without the needs of code compilation. No load json is required.

Special Keycodes

Based on V1.01 revision:

  1. KBRST: reset trackball configuration cpi500, reset to default scrolling speed
  2. KBSAVE: save your trackball configuration so this can be loaded on your next restart, else it will go to the default configure of trackball.
  3. CPI+: increase cpi+100, move cursor faster (max cpi12000)
  4. CPI-: decrease cpi-100, move cursor slower (min cpi100)
  5. CPI++: increase cpi+1000, move cursor super fast (max cpi12000)
  6. CPI--: decrease cpi-1000, move cursor super slow (min cpi100)
  7. SCRMO: hold to scroll
  8. SCRTO: toggle scroll on or off
  9. SNIP: hold so it goes super slow for precision. released goes to pre-saved trackball configuration as in KBSAVE.

Switch Installation

 

Troubleshooting

Certain keys are not registered

Check any bent pins on your switch.

Keys not mapping

Launch one application each time. Use Vial instead of Via. Do not launch together to avoid conflict.

Keyboard acting weird with inactive layer etc.

Make sure usb-c inserted to right, not left.

 


Firmware

V1.02

Correction on Vial keycodes as some are not working. Add SNIP in user tab.

Add SNIP in layer 2.

10 layers

Enable split rgb.

Enable media keys.

RGB can go to sleep when pc sleeps.