Lily58 Pro Build Guide [WIP]

Required parts

Part nameQuantityRemarksPhoto
Lily 58 PCB2 pieces
Lily 58 case1 set (4 pieces)2 solid panels, 2 with holes for switches
ProMicro2 piecesOptionally, use a spring pin header (con-through) to reduce soldering and avoid damage to the fragile ProMicro board. (The recommended con-through part is included in the kit sold at YushaKobo.)
Key switch (Cherry MX, Kailh choc)58 piecesMX switch and choc switches use separate connectors
Switch socket58 piecesNecessary for key switch installation
Diodes 1N4148W58 pieces
Key caps58 pieces1.5U caps, can also be 1U
OLED module2 pieces
Tact switch2 piecesTactile reset switch
TRRS jack2 pieces
M2 spacer10 pieces, 4 piecesChoc: 4mm, MX: 7mm
M2 screw28 pieces
TRRS cable1 cableCable for 3.5 mmaudio, also called AUX cable (4-pole cable recommended)
Micro USB Cable1 pcsMagnetic connector recommended due to the low durability of the ProMicro socket


The Pro version has color variations, and the photos in this build guide are are of the black version, but the white verison is functionally identical. Depending on the color and release date, some parts may differ, but there is no difference in operation.

Note that the case of the black version has a scratch-resistant paint (solder resist) that can arrive with scratches from shipping and transportation. This is the nature of the product.

In addition, please be careful, as the case will be scratched if it hits or rubs a hard thing after assembly.

This substrate (PCB) is reversible. We will mount parts on each side.

Mark the surface with masking tape to make it easy to keep track of the back and front of each board. 51965707-c6841d80-24ad-11e9-8e00-b7113b20fb67 unadjustednonraw_thumb_2ccb

Attach the diodes

The diodes are supplied in a plastic tape reel. It's easy for the components to fly out when peeling back the tape, so open it slowly and carefully. (It's easier to work the diodes if you cautiously open the container onto a small plate.) 2019-01-26 13 52 14

The diodes are mounted on the back side of the board.

Solder with the diode wire always pointing in the direction of the arrow symbol drawn on the board (shown in the following figure). If the orientation is incorrect, the key will not respond. 2019-02-28 14 08 00

Apply preliminary solder (melt a small amount on the substrate) on one pad of the PCB diode. 2019-01-26 13 48 26

Then use tweezers to solder one side of the diode, using the pre-soldering to secure the diode. 2019-01-26 13 54 10 Then solder the remaining side.

When all diodes have been soldered, check for missing spots. 2019-01-26 14 18 25

You can use a multimeter on the front side of the board to ensure that the solder connections are good and that the orientation of the diodes is correct.

Solder the sockets

The sockets are mounted on the back side, the same side as the diodes.

Much like the approach used for the diodes above, begin by pre-soldering one side of the socket pad, place the component, and hold it in place with tweezers. (The sockets can also be held in place by hand, but please take extra care not to burn yourself.) The image shows a soldered MX socket; please install Choc socket on the lower side. socket

For parts that require force, firmly solder both pads and check the final result for any looseness/wiggling. 2019-01-26 14 38 04

Soldering the TRRS jack and reset switch

The TRRS jack and the reset switch are mounted on the front side (the one with the sticker on the mark). Attach the parts and fix them temporarily with masking tape. Turn over the board and solder the pins, making sure that the TRRS jack and reset switch are in firm contact with the board. 2019-01-26 14 39 53 2019-01-26 14 43 23

Attach the OLED display

On the front side of the board, apply enough solder to bridge the four jumper terminals in the ProMicro section. Attach the connector for the OLED, much like the TRRS jack above. Be careful to avoid adding a lot of solder, as it is easy for solder to flow into the connector. unadjustednonraw_thumb_2db2

Insert the OLED pin into the socket, attach the OLED module to it, and solder the four pins.

Install Pro Micro

The pin header enclosed in the bag of ProMicro is not used. For kits purchased at YushaKobo, a spring pin header is included, so use that. IMG_2662 When attaching with a spring pin header (con-through), solder it according to the method described in the Helix build guide and then attach it to the Lily 58 PCB. Helix build guide

Note the outlined sets of holes in PCB, and insert the ProMicro into the outlined holes. Please be careful, as the connections are different for the right and left boards.


Attach the spacer

Attach four 10mm round spacers to the holes near ProMicro. It's easy to insert a screw from the back of the board and attach the spacer from the top. 2019-01-26 15 02 38

Peel off the masking tape used to identify the front and back of the board.

Attach the key switch

Attach the top plate spacers for alignment. (MX: 7mm Choc: 4mm) 2019-01-26 14 56 05 2019-01-26 14 56 24

Attach four key switches to the top plate. (In the case of Choc switches, starting with two switches in the plate may be easier.) 2019-01-26 14 58 48

Insert the switch into the board for alignment, and line up the components. 2019-01-26 15 01 12

After confirming that there are no bends in the switch pins, you can attach it firmly by starting from the middle row and working outward. Be careful: KailhBOX switches and Choc switches require some power for installation. After mounting the plate, push the switches again to make sure that installation is complete. 2019-01-26 15 10 06

ProMicro protective acrylic installation

Peel off the protective plastic layer covering the acrylic, and attach the acrylic to the board. Mount with the wider side (labeled "幅が広い" here) outwards.

Attach with screws.

2019-01-26 15 21 15

Write key map

The board requires a keymap in order to function. This section assumes that you're familiar with keymaps and the use of the QMK tool. If not, please refer to the QMK "Getting Started" guide (Windows: MSYS2; Mac, Linux: avrdude)

The QMK Toolbox can be used to write non-customized keymaps via a GUI, avoiding the need to configure a local QMK environment. (For custom keymaps, it's recommended to build the full environment described above).

Execute the following in the qmk_firmware directory to write the default Lily58 keymap

sudo make lily58:default:avrdude

When Detecting USB port, reset your controller now ... is displayed, press the reset button on the keyboard to start writing. Each half of the keyboard must be programmed separately using this approach.

Default keymap

The default keymap is laid out on the assumption that it will be used in the MacOS/US keyboard environment. Feel free to get creative and experiment with keymaps that match your preferences; consider changing to the JIS layout or adding a key to switch between English and Kana, for example.

The best of my own keyboard: lily58_default

Operation check

Connect the left and right sides with a TRRS cable, connect the MicroUSB cable to ProMicro on the left side (in the case of the default key map), and check if the key responds. The build is completed by attaching the four rubber feet to the back of each board. Thank you for your hard work. 2019-01-26 15 24 52 unadjustednonraw_thumb_2ddc

When in trouble

Q. One or more rows/columns of key switches do not respond

A. The ProMicro board may not be soldered and attached firmly. Check again, and re-solder and reinstall if necessary.

Q. A single key switch doesn't respond

A. There may be a problem with the key switch's insertion, socket or diode soldering.

In the case of bad key switch insertion: After removing the key switch, make sure that the pins aren't bent, and then push it in again and install it.

In the case of badly attached socket: Re-solder the problem socket, or reflow and add solder if the joint is weak.

In the case of badly attached diode: Check the direction of the diode in question. If it is wrong, remove it and re-solder it. Additionally, if there isn't enough solder, please re-solder.

Q. A symbol different from the symbol input by "@" or "[" etc. is input (on Windows, etc.)

Since recognition of keyboard is recognized as JIS keyboard on OS, another symbol will be input when inputting with Lily 58 (treated as US keyboard). Please set Lily 58 as a US keyboard in the OS keyboard settings. After switching, switching to Japanese input becomes the switching key for the US keyboard, and it differs from the JIS keyboard, so please be careful (it can be customized with the key map etc.).

If you have any problems, please feel free to send a message to the "#Lily58" channel on Discord ("Self-Made Keyboards in Japan" ( or Twitter: @F_YUUCHI

Change the key map

This self-made keyboard use the QMK firmware, described above. The QMK firmware is highly customizable, and you can unlock a lot functionality simply by editing the key map.

Edit keymap.c and customize

When customizing a keymap, start by making a copy of the qmk_firmware/keyboards/lily58/keymaps/default folder and modifying that directory's internal keymap.c file. Please refer to the official QMK documentation for the key codes and programming specifics.

After changing the key map,

sudo make lily58:(any folder name):avrdude

If you get an error, please double-check the board, connection and command.

How to customize using QMK Configurator (deprecated)

If you use QMK Configurator, you can create an original keymap on the browser without editing the keymap.c file. Load the downloaded JSON file into the QMK Toolbox and write it to the boards.