This page will give a quick guide on what you'll need to build a keyboard with the nice!60, battery details, and how to customize your keymap.
When installing the battery on the nice!60, you'll notice it has a 3-pin JST-PH connector. This is done to accommodate batteries with the power or ground flipped either way. Make sure the red wire is being plugged into the PWR pin (in the middle) and the black wire is plugged into the GND pin (on the ends).
If you're using a metal case with your nice!60, please take care to insulate the middle post and not tighten the screw too much. This post unfortunately cannot have the same through hole pad protections that the rest of the posts have due to the hotswap sockets. Failure to properly insulate the middle post on metal cases can result in the "6yhn" column breaking due to shorts.
Here is a building stream of a nice!60 to guide you with your build.
The nice!60 is preloaded with the ZMK firmware using the below keymap. Read more about ZMK here.
Check out the ZMK docs on how the wireless BLE works.
Generally to manage your profiles, you will use the first column of keys on the left side of the board on the function layer.
Fn key and the
Esc key to erase the bond/device on the current active profile and go back into pairing mode.
BT 1/2/3/4 keys on the left side on the
Fn layer to switch between profiles.
Of course, the default keymap will not be perfect for everyone, so you can update your keymap and build new firmware without installing anything on your computer.
You will need a GitHub account to do this.
Navigate to https://github.com/Nice-Keyboards/nice60-zmk-config
Press the Fork button in the top right
After forking is complete, click on the Actions tab
Click on the "I understand" button to enable building your firmware using GitHub Actions
Next click back to the Code tab to the left of the Actions tab
Now we can edit the keymap. Click on the
Now click on the
Click on the edit button
Edit the keymap as wanted. Use the ZMK codes docs to find standard HID input options you have for your keymap and check the Behaviors category on the left to find other ZMK specific behaviors.
When done, scroll to the bottom and commit your changes. Feel free to add a commit title and description to track your changes
Your new firmware should now be building. The first build will take a while. Click on the Actions tab to see the status. When it's complete it will have a green check instead of a yellow dot. If you have an error, you've probably missed a comma, semicolon, or typed in a non-existent key type. Check this for more information. Your
nice60.dts.pre.tmp file is printed in the step after build.
If your firmware builds properly, click on the build title
Now click the
nice60-zmk link to download your new firmware
Unzip the files. You should have a
zmk.uf2 file, which you'll use
Take your nice!60 and double-press the reset button on the back below the USB-C port and plug in the board to your computer
You should get a new drive called
NICE60 if you properly double-pressed the reset button. Drag and drop or copy the
zmk.uf2 you have over to that drive
After it's done your board should auto boot back into your new ZMK firmware. You're done!