Skip to content

Instantly share code, notes, and snippets.

@twalker
Last active September 17, 2024 03:24
Show Gist options
  • Save twalker/9afe1a860e37aa227b0e82842c068f4f to your computer and use it in GitHub Desktop.
Save twalker/9afe1a860e37aa227b0e82842c068f4f to your computer and use it in GitHub Desktop.
getting-as-started-lily58

Getting Started

Enclosed is your custom built wireless Lily58 keyboard.

  1. Turn on ("Right on, Left off.") each of the two halves using the small toggle under the USB-C port.
  2. The keyboard should appear in bluetooth settings as "Lily58". Connect to it to pair your computer with the keyboard. Alternatively, connect a USB-C cable between the left half and your computer.
  3. Type and turn knobs!

The default Lily58 keymap has been flashed onto the keyboard.

The hardware

  • Hot swappable MX switch sockets
    The switches can be changed without any desoldering.
  • Socketed nice!nano microcontrollers which can be removed for upgrades or replacement.
  • nice!view low power OLED Screens
  • EC11 Rotary Encoders
  • Clones of Holy Panda key switches
  • MT3 Keycaps. The keycaps can be be replaced with any other MX compatible keycaps--a keycap/switch pulling tool is needed.
  • Lily58 designed by kata0510--a fellow software engineer in Japan.
  • 3D Printed Case, and a custom display cover I needed

The keyboard is high profile. If you rest your palms when typing, the Fellowes Crystals Gel wrist rests work well with split keyboards--here's a cheaper option.

The software

  • ZMK open source firmware
  • Getting started with ZMK -- sets up a personal repository for re-configuring your keyboard. Let me know once you do, and I can open a PR for the changes needed to support the display (nice!view).
  • The Online Visual Keymap editor provides a nice UI to edit keymaps and will open PRs against your zmk config repository.

Training sites

  • keybr to learn key positions and reduce errors with adaptive machine learning.
  • monkeytype to practice prose, symbols, and numbers (extremely configurable -- check the funbox).
  • typing.io to practice coding.

Videos

Support

Neary every part of the keyboard (switches, keycaps, case, etc) can be replaced or swapped with a different part you may like better. If you have any questions on using, programming, or any want to change any aspect of the keyboard, contact me at [email protected]

@twalker
Copy link
Author

twalker commented Sep 17, 2024

Lily58 Default keymap

Base

lily58-base-layer

Lower

lily58-lower-layer

Raise

lily58-upper-layer

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment