Skip to content

Keychron/qmk_configurator

This branch is 4 commits ahead of, 268 commits behind qmk/qmk_configurator:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

7f2352e · Feb 28, 2022
Jan 20, 2022
Dec 20, 2019
Nov 25, 2021
Nov 25, 2021
Aug 31, 2021
Feb 28, 2022
Jan 19, 2022
Jan 20, 2022
Jan 19, 2022
Feb 11, 2019
Jun 3, 2019
Jan 19, 2022
Jun 1, 2021
Jan 19, 2022
Aug 20, 2019
Jan 14, 2022
Jan 19, 2022
Jan 20, 2022
Feb 26, 2020
Jan 19, 2022
May 23, 2019
Jan 19, 2022
Jan 15, 2020
Feb 11, 2019
Mar 23, 2021
Jan 19, 2022
Feb 11, 2019
Aug 28, 2021
Jan 19, 2022
Jan 19, 2022
Jan 19, 2022

Repository files navigation

Quantum Mechanical Keyboard Configurator

Build Status Known Vulnerabilities Discord GitHub contributors GitHub forks

The QMK Configurator is an online tool used for easily creating firmware files for keyboards supported in qmk_firmware. The tool is located on https://config.qmk.fm.

The QMK Configurator allows simple keymap creation and saving via .json keymap files, and generates appropriate firmware files for flashing onto selected keyboards.

This project is very much a work in progress. To begin contributing, please refer to the following:

Development

We recommend you install and use NVM to manage node versions. There is a .nvmrc file in the root of the project directory that has been tested with our dependencies.

Select node version

nvm use

Project setup

yarn install

Compiles and hot-reloads for development

yarn run dev

Compiles and minifies for production

yarn run build

Run your tests

yarn run test

Lints and fixes files

yarn run lint

Run your end-to-end tests

Start the server separatly

yarn run test:cypress

Run your end-to-end tests like CI

Start the server separatly

yarn run test:cypress:ci

Run your unit tests

yarn run test:unit

Customize configuration

See Configuration Reference.

Docker

If you don't have a webserver already and don't already have one in mind you can use docker. By default it spins up a self-contained environment.

docker run -p 8080:80 qmkfm/qmk_configurator:latest

You can specify a different backend URL by setting VUE_APP_API_URL:

docker run -e VITE_API_URL=http://localhost:8080 -p 8080:80 qmkfm/qmk_configurator:latest

If you'd like to develop locally you can use a volume to tie your local filesystem to the container:

docker run --mount type=volume,source=.,target=/qmk_configurator -p 8080:80 qmkfm/qmk_configurator:latest

Building The Docker Image

Most of the time you don't need to do this, you can use volume mounts as described above to use the pre-built image with your local tree.

If for some reason you do need to build it yourself, you can use this command:

docker build -t qmk_configurator .

This process will take a while. You may want to go make some tea or something. When it finishes you can run it with this command:

docker run -p 8080:80 qmk_configurator

Internationalization Guide

Please refer to this document

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 45.6%
  • Vue 34.8%
  • SCSS 18.6%
  • Other 1.0%