Zypomorph uses QMK firmware. Documentation on installation, keymaps and compiling can be found here.

If QMK Toolbox doesn't work, try these steps

My fork of QMK can be found here

To install the default keymap:

  1. Install AVRdudess

    1. You may need to install Atmel Flip drivers and follow this guide after resetting the board.

  2. Download the left/right eeprom files and .hex files here

    1. Right-click each link and "Save link as..." or download the whole repo

  3. Flash the left half

    1. Programmer: Choose FLIP USB DFU protocol version 1 (doc7618)

    2. Port: usb

    3. MCU: ATmega32U4

    4. Flash: choose your hex file

    5. EEPROM: chooseeeprom-lefthand.eep

    6. Use a piece of metal to short the two pads marked RESET

    7. PressProgram!

  4. Flash the right half

    1. Place some tweezers/ wire into the holes next to the MASTER jumper. This is needed to activate the USB port, and can be removed after flashing.

    2. Plug in the right half alone, into the unused USB port.

    3. Follow the same steps as the left, but chooseeeprom-righthand.eep and zygo-noRGB.hex

      1. If you're updating the firmware for the right side, make sure RGB is disabled for the slave side.

    4. Remove your jumper wire/tweezers

  5. Plug the leftmost port into your PC, and the two middle ports into each other.

  6. After the initial setup, you can update your keymap using QMK Toolbox, and you only need to flash the master half.

For custom layouts:

  1. Install and setup QMK and Avrdudess

  2. Edit your keymap as desired and compile hex file

  3. Flash the hex to the master (follow guide above)

Last updated