This is a keyboard firmware based on the tmk_keyboard firmware with some useful features for Atmel AVR and ARM controllers, and more specifically, the OLKB product line, the ErgoDox EZ keyboard, and the Clueboard product line.

• See the official documentation on docs.qmk.fm

The docs are powered by VitePress. They are also viewable offline; see Previewing the Documentation for more details.

You can request changes by making a fork and opening a pull request.

• Planck
• Preonic
• ErgoDox EZ
• Clueboard
• Cluepad
• Atreus

The project also includes community support for lots of other keyboards.

QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, Hasu. The OLKB product firmwares are maintained by Jack Humbert, the Ergodox EZ by ZSA Technology Labs, the Clueboard by Zach White, and the Atreus by Phil Hagelberg.

qmk.fm is the official website of QMK, where you can find links to this page, the documentation, and the keyboards supported by QMK.

This is a fork of QMK 0.26.11 including keymaps for the Drop ALT V1 keyboard. Support for the Drop ALT V1 was removed in QMK 0.27.0.

Note that Drop, formerly Massdrop, has their own fork of QMK. See this post for more information.

Run the following command to clone this fork and set your QMK home directory.

$ qmk setup -H <qmk_firmware-directory> RecursiveVisions/qmk_firmware

The default keyboard for this fork is the Massdrop ALT.

$ qmk config user.keyboard=massdrop/alt

Run the following commands to compile and flash the main keymap. The Massdrop ALT uses the mdloader firmware loader that must be downloaded first if you are not using QMK Toolbox.

$ qmk compile -km <keymap-name>
$ ./mdloader --first --download <compiled-binary> --restart

Running qmk compile will produce a compiled binary that can be flashed to the keyboard using QMK Toolbox or mdloader. Running ./mdloader will scan for a device. Within 60 seconds, hold FN + B for at least 250 ms to flash the firmware.

The main keymap is recursivevisions. There is a minimal version of the keymap (with various features stripped) named recursivevisions_minimal (WIP).

The project structure is as follows.

.
└── keyboards/
    └── massdrop/
        └── alt/
            └── keymaps/
                ├── recursivevisions/
                │   ├── custom_animations
                │   └── ...
                └── recursivevisions_minimal/
                    └── ...

Note that in VS Code, this fork excludes all directories in keyboards from the Explorer other than keyboards/massdrop and keyboards/drop.