Generic configurator for QMK intended to support via GUI all that QMK is capable of.
- Install Docker: https://www.docker.com/products/overview
- Clone the repository, and fetch the QMK submodule:
git clone git@github.com:evangs/QMK-Configurator.git
cd QMK-Configurator
git submodule init
git submodule update
- Next, enter the QMK directory and fetch it's submodules:
cd qmk_firmware
make git-submodule
cd ..
- Finally, spin up the Docker container to launch the server:
docker build -t miniconfig .
docker run -it --rm -p 8000:80 -e PORT=80 --name my-running-app miniconfig
- Navigate to http://localhost:8000 in your web browser
- Keyboard key symbols: http://xahlee.info/comp/unicode_computing_symbols.html
If you start to get “No space left on device” error, run the following commands to remove unused images/containers.
docker rm $(docker ps -q -f 'status=exited')
docker rmi $(docker images -q -f "dangling=true")
Feel free to make a pull request with any bug fixes, features, or support for new keyboards.