Setup

Latest Update: 2021-04-27


Download Software 

Prepare Your Build Environment 

Run QMK Setup 

Test Your Build Environment

Download Software & Setup Folder


Mac & Win

  1. Create new folder: Users>[your user name]>Dev

  2. Download VHD - QMK firmware to Dev, and upzip

  3. Download nRF5_SDK to Dev, and unzip

  4. Download Visual Studio Code and install

  5. Download Python and Install

press to zoom

press to zoom

press to zoom
1/2

Hardware

Software

Support

Prepare Your Build Environment


Mac

  1. Open Terminal.app

  2. Install Homebrew - Run command on Terminal

  3. Run this command: brew install qmk/qmk/qmk


Win

  1. Download MSYS64 (Zip, 1.4GB) and upzip to C:/


Linux

  1. Follow the guide from here

  2. After installed, if you can't make the keyboard hex file. Please try to downgrade the compiler version.


Guide for all OS 

https://docs.qmk.fm/#/newbs_getting_started

1/0

Run QMK Setup


Mac

  1. Run this command: qmk setup

  2. In most situations you will want to answer "y" to all of the prompts.


Win

We helped you setup already.

1/0

Test Your Build Environment


  1. Run: python3 --version, you should see: eg: Python 2.7 or Python 3.10

  2. Run this command for testing: qmk compile -kb clueboard/66/rev3 -km default

  3. When it is done you should have a lot of output that ends similar to this: 

Linking: .build/clueboard_66_rev3_default.elf  [OK] 

Creating load file for flashing: .build/clueboard_66_rev3_default.hex  [OK] 

Copying clueboard_66_rev3_default.hex to qmk_firmware folder   [OK] 

Checking file size of clueboard_66_rev3_default.hex   [OK]

* The firmware size is fine - 26356/28672 (2316 bytes free)


Your qmk has been setup.

1/0
1/0