Skip to content

Instantly share code, notes, and snippets.

@twalker
Last active January 16, 2026 03:39
Show Gist options
  • Select an option

  • Save twalker/9afe1a860e37aa227b0e82842c068f4f to your computer and use it in GitHub Desktop.

Select an option

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 tim.twalker@gmail.com

@twalker
Copy link
Author

twalker commented Sep 17, 2024

Lily58 Default keymap

Base

lily58-base-layer

Lower

lily58-lower-layer

Raise

lily58-upper-layer

@atron3030
Copy link

Love it! Thanks so much for the keyboard and all the great documentation!!

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