/mechwild-zmk-config

A user config repo for MechWild ZMK keyboards. This one is a replacement for all the other user config repos that used to be here.

MIT LicenseMIT

MechWild's ZMK User Config Repo

Instructions

Brand new to ZMK?

  1. You will need to sign up for a GitHub account, and fork this repository so you can edit it.
  2. Navigate to the Actions tab and click the "I understand my workflows, go ahead and run them" button to enable builds. Actions tab with "I understand my workflows" button
  3. Edit the files for your keyboard(s) in the config folder. .conf files configure keyboard features, and .keymap files change the keymap. Settings in default.conf will apply to all keyboards; to make keyboard-specific changes, create a file named after the keyboard (e.g. bb40.conf) and change the settings there.
  4. Edit the build.yaml file to include the board(s) and/or shield(s) you need to build firmware for.
  5. After committing your changes, your firmware will begin compiling. Assuming there are no typos or other problems, it will eventually be downloadable from the Actions tab.
  6. Flash the firmware that matches the board and/or shield you're using, e.g. bb40-pillbug-zmk.uf2 for a BB40 using a PillBug.

Already have a ZMK user config repo?

The keymaps here may still be useful, but you probably want to add the mechwild-zmk-keyboards ZMK module to your existing west manifest instead.

Want to know more?

Check the MechWild ZMK module for additional information such as:

Common Questions/Problems

There was an error and the build didn't finish.

There is probably an error in your keymap.

Clicking into the details of the action will show the error log. While very long, this log will often show the exact line number causing the problem in your keymap so it is worth reading closely. Check this against the last changes you made.

Keep in mind that each ZMK "keycode" is made up of a behavior which always has an & in front (e.g. &kp for a key press), followed by any details for that behavior. Resetting to bootloader is just &bootloader while the letter Z is &kp Z. And "select Bluetooth profile #1" is &bt BT_SEL 1). Read the docs closely.

Using nickcoutsos's in-browser keymap editor, which provides a GUI for editing keymap files, can be very helpful.

After disconnecting the keyboard from Bluetooth, it won't reconnect.

Forget the Bluetooth connection on both the keyboard and the host, then try re-pairing.

If you don't remember which profile on the keyboard was used to connect to a specific host, you may have to clear them all. See ZMK's documentation for more information.

As a last resort, try flashing the settings_reset firmware for your board; this will force-clear everything.

Further Troubleshooting Resources