Custom QMK Profiles

Steps to dive into the QMK source to tweak keymaps, encoder behavior, and more.
This will use the matrice_pad_classic_dial keyboard in command examples.

1. Clone & Install QMK

Ubuntu / Linux

1. Make sure you have git, python3, and the QMK build tools.
   
   

   				sudo apt update
   				sudo apt install git python3 python3-pip gcc-avr avr-libc dfu-programmer dfu-util

2. 
   Clone QMK and run its installer:
   
   

   				git clone https://github.com/qmk/qmk_firmware.git
   				cd qmk_firmware
   				til/qmk_install.sh

Windows (QMK MSYS)

1. Install QMK MSYS from the official repo, then launch the “QMK MSYS” shell.
   
   No commands needed here—just run the installer and open the MSYS terminal.
2. In the MSYS shell, update packages and install dependencies:
   
   

   				pacman -Syu
   				pacman -S mingw-w64-i686-toolchain mingw-w64-i686-avr-gcc \
   				mingw-w64-i686-avr-libc mingw-w64-i686-dfu-util \
   				mingw-w64-i686-dfu-programmer make git python3

3. 
   Clone QMK and run its installer:
   
   

   				cd ~
   				git clone https://github.com/qmk/qmk_firmware.git
   				cd qmk_firmware
   				util/qmk_install.sh

2. Add Our Keyboard Directory

Place the matrice_pad_classic_dial folder under qmk_firmware/keyboards/matrice_technologies/. Your tree should look like:

				qmk_firmware/
				└── keyboards/
				    └── matrice_technologies/
				        └── matrice_pad_classic_dial/
				           ├── config.h
				           ├── rules.mk
				           ├── keyboard.json
				           └── keymaps/
				              └── default/
				                 └── keymap.c
				

3. Compile Your Custom Hex

From the qmk_firmware root, run the compile command for your platform:

Ubuntu / Linux

qmk compile -kb matrice_technologies/matrice_pad_classic_dial -km default

Windows (QMK MSYS)

qmk compile -kb matrice_technologies/matrice_pad_classic_dial -km default

4. Flash to Your Device

1. Open QMK toolbox
2. Select the correct file in the dropdown (that you downloaded)
3. Enable the auto-flash option (optional, but helps)
4. Connect your macropad to your computer
5. With a paper clip or pin, click the reset board under the macropad, the flashing process should start
6. Once the flashing process completes (~5-10s), you may use your board