# QMK CLI Commands # User Commands ## `qmk compile` This command allows you to compile firmware from any directory. You can compile JSON exports from , compile keymaps in the repo, or compile the keyboard in the current working directory. This command is directory aware. It will automatically fill in KEYBOARD and/or KEYMAP if you are in a keyboard or keymap directory. **Usage for Configurator Exports**: ``` qmk compile ``` **Usage for Keymaps**: ``` qmk compile -kb -km ``` **Usage in Keyboard Directory**: Must be in keyboard directory with a default keymap, or in keymap directory for keyboard, or supply one with `--keymap ` ``` qmk compile ``` **Usage for building all keyboards that support a specific keymap**: ``` qmk compile -kb all -km ``` **Example**: ``` $ qmk config compile.keymap=default $ cd ~/qmk_firmware/keyboards/planck/rev6 $ qmk compile Ψ Compiling keymap with make planck/rev6:default ... ``` or with optional keymap argument ``` $ cd ~/qmk_firmware/keyboards/clueboard/66/rev4 $ qmk compile -km 66_iso Ψ Compiling keymap with make clueboard/66/rev4:66_iso ... ``` or in keymap directory ``` $ cd ~/qmk_firmware/keyboards/gh60/satan/keymaps/colemak $ qmk compile Ψ Compiling keymap with make make gh60/satan:colemak ... ``` **Usage in Layout Directory**: Must be under `qmk_firmware/layouts/`, and in a keymap folder. ``` qmk compile -kb ``` **Example**: ``` $ cd ~/qmk_firmware/layouts/community/60_ansi/mechmerlin-ansi $ qmk compile -kb dz60 Ψ Compiling keymap with make dz60:mechmerlin-ansi ... ``` ## `qmk flash` This command is similar to `qmk compile`, but can also target a bootloader. The bootloader is optional, and is set to `:flash` by default. To specify a different bootloader, use `-bl `. Visit the [Flashing Firmware](flashing.md) guide for more details of the available bootloaders. This command is directory aware. It will automatically fill in KEYBOARD and/or KEYMAP if you are in a keyboard or keymap directory. **Usage for Configurator Exports**: ``` qmk flash -bl ``` **Usage for Keymaps**: ``` qmk flash -kb -km -bl ``` **Listing the Bootloaders** ``` qmk flash -b ``` ## `qmk config` This command lets you configure the behavior of QMK. For the full `qmk config` documentation see [CLI Configuration](cli_configuration.md). **Usage**: ``` qmk config [-ro] [config_token1] [config_token2] [...] [config_tokenN] ``` ## `qmk doctor` This command examines your environment and alerts you to potential build or flash problems. It can fix many of them if you want it to. **Usage**: ``` qmk doctor [-y] [-n] ``` **Examples**: Check your environment for problems and prompt to fix them: qmk doctor Check your environment and automatically fix any problems found: qmk doctor -y Check your environment and report problems only: qmk doctor -n ## `qmk info` Displays information about keyboards and keymaps in QMK. You can use this to get information about a keyboard, show the layouts, display the underlying key matrix, or to pretty-print JSON keymaps. **Usage**: ``` qmk info [-f FORMAT] [-m] [-l] [-km KEYMAP] [-kb KEYBOARD] ``` This command is directory aware. It will automatically fill in KEYBOARD and/or KEYMAP if you are in a keyboard or keymap directory. **Examples**: Show basic information for a keyboard: qmk info -kb planck/rev5 Show the matrix for a keyboard: qmk info -kb ergodox_ez -m Show a JSON keymap for a keyboard: qmk info -kb clueboard/california -km default ## `qmk json2c` Creates a keymap.c from a QMK Configurator export. **Usage**: ``` qmk json2c [-o OUTPUT] filename ``` ## `qmk list-keyboards` This command lists all the keyboards currently defined in `qmk_firmware` **Usage**: ``` qmk list-keyboards ``` ## `qmk list-keymaps` This command lists all the keymaps for a specified keyboard (and revision). This command is directory aware. It will automatically fill in KEYBOARD if you are in a keyboard directory. **Usage**: ``` qmk list-keymaps -kb planck/ez ``` ## `qmk new-keymap` This command creates a new keymap based on a keyboard's existing default keymap. This command is directory aware. It will automatically fill in KEYBOARD and/or KEYMAP if you are in a keyboard or keymap directory. **Usage**: ``` qmk new-keymap [-kb KEYBOARD] [-km KEYMAP] ``` --- # Developer Commands ## `qmk cformat` This command formats C code using clang-format. Run it with no arguments to format all core code that has been changed. Default checks `origin/master` with `git diff`, branch can be changed using `-b ` Run it with `-a` to format all core code, or pass filenames on the command line to run it on specific files. **Usage for specified files**: ``` qmk cformat [file1] [file2] [...] [fileN] ``` **Usage for all core files**: ``` qmk cformat -a ``` **Usage for only changed files against origin/master**: ``` qmk cformat ``` **Usage for only changed files against branch_name**: ``` qmk cformat -b branch_name ``` ## `qmk docs` This command starts a local HTTP server which you can use for browsing or improving the docs. Default port is 8936. **Usage**: ``` qmk docs [-p PORT] ``` ## `qmk kle2json` This command allows you to convert from raw KLE data to QMK Configurator JSON. It accepts either an absolute file path, or a file name in the current directory. By default it will not overwrite `info.json` if it is already present. Use the `-f` or `--force` flag to overwrite. **Usage**: ``` qmk kle2json [-f] ``` **Examples**: ``` $ qmk kle2json kle.txt ☒ File info.json already exists, use -f or --force to overwrite. ``` ``` $ qmk kle2json -f kle.txt -f Ψ Wrote out to info.json ``` ## `qmk pyformat` This command formats python code in `qmk_firmware`. **Usage**: ``` qmk pyformat ``` ## `qmk pytest` This command runs the python test suite. If you make changes to python code you should ensure this runs successfully. **Usage**: ``` qmk pytest ```