QMK CLI

A program to help users work with QMK Firmware.

Features

• Interact with your qmk_firmware tree from any location
• Use qmk clone to pull down anyone's qmk_firmware fork
• Setup your build environment with qmk setup
• Use qmk console to get debugging information from your keyboard(s)
• Check that your environment is correctly setup with qmk doctor
• Integrates with qmk_firmware for additional functionality:
  • qmk compile
  • qmk info
  • qmk flash
  • qmk lint
  • ...and many more!

Packages

We provide "install and go" packages for many Operating Systems.

Linux

Packages for several distributions available here: https://github.com/qmk/qmk_fpm

macOS

Using Homebrew:

brew install qmk/qmk/qmk

Windows

Download our custom MSYS2 installer here: https://msys.qmk.fm/

Quickstart

• python3 -m pip install qmk
• qmk setup

Building

We follow PEP517, you can install using build:

Setup:

python3 -m pip install build

Build:

python3 -m build

You can read more about working with PEP517 packages in the Python Packaging User Guide.

Documentation

Full documentation: https://docs.qmk.fm/#/tutorial