This is a quick config key remap for Sofle Zmk.
![]() |
|---|
| Sofle LP niceview: 50g choc brown, niceview, cf plate, customised abs case, cfx keycaps white |
- Use Keymap Editor to remap the keys.
- This is for Sofle with encoders and niceview display.
Add this to keymap.c if you have your own repo. This is to enable niceview. If you fork this repo, you can ignore this.
&nice_view_spi {
cs-gpios = <&pro_micro 0 GPIO_ACTIVE_HIGH>;
};
![]() |
|---|
![]() |
|---|
![]() |
| 1. Fork this to your github, make sure you have created a github account. |
![]() |
2. Untick this so it allows you to copy niceview and oled branches, then create fork. |
![]() |
3. Click action |
![]() |
4. Click the left .github/workflows/build..., and click Run workflow on right. Wait it run for a few minutes until a green tick. |
![]() |
5. Go to Keymap Editor. |
![]() |
6. Choose Add/remove repo... |
![]() |
6. Sign in to your github account and select repo.., choose zmk_config_sofle and save. |
![]() |
7. Now choose your repo and correct branch, and you can start mapping. Once it is done click save, wait until it finished compiling then click Latest. |
![]() |
8. Scroll down and go to download Firmware. |
You may refer to the demo for flashing procedure. Details as follow:
- Connect left and right splits to your pc (both connect together using type c cable). You also can flash one side each time without using two cables.
- Put right into bootloader mode (press the reset button), one window is popped out showing "nicenano" folder. Dont do anything yet, remember this folder as right split.
- Now press reset button on your left split, one window will be popped out as previous step.
- Drag left and right uf2 to respective folders.
- Do not disconnect right split yet.
- Remove left split from type c cable. Proceed to
First time bluetooth connectionto connect your board to pc. If successfully connected, you shall able to type without cable now. - If so, remove the right split from type c cable. Both should be working good now!
- If you dont have extra usb c cable...You can do left first, then quickly move to right so the right can sync with left.
- Mac or Window OS connected but not responding, this is working for Bluetooth 5.2 Windows.
- Master connected and can type, but not slave refer to Split Keyboard Halves Unable to Pair.
- You may compile the reset.uf2 yourself or get it from setting reset.uf2.
- The board is pre-flashed with the mouse-native.uf2. You may always use these to test the board.
- No key is registering: have you toggled the power button? (if you have one)
- Blue light: you are connected to usb c and the board is charging
- Slight blue light blinking: you are connected to usb c but not connected to battery. Toggle power button to allow charging.
- Blink red once: when you toggle the power button on
- Flashing red: no firmware flashed to the mcu yet
- Blue light: you are connected to usb c and the board is charging
- Blue blinking: bootloader mode, no firmware is loaded











