qmk_firmware/keyboards/keychron/q8/readme.md

# Keychron Q8

![Keychron Q8](https://i.imgur.com/FQnOwRrh.jpg)

A customizable 65% Alice layout keyboard.

* Keyboard Maintainer: [Keychron](https://github.com/keychron)
* Hardware Supported: Keychron Q8
* Hardware Availability: [Keychron Q8 (Alice Layout) QMK Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q8-alice-layout-qmk-custom-mechanical-keyboard)

Make example for this keyboard (after setting up your build environment):

    make keychron/q8/ansi:default
    make keychron/q8/ansi_encoder:default
    make keychron/q8/iso:default
    make keychron/q8/iso_encoder:default

Flashing example for this keyboard:

    make keychron/q8/ansi:default:flash
    make keychron/q8/ansi_encoder:default:flash
    make keychron/q8/iso:default:flash
    make keychron/q8/iso_encoder:default:flash

**Reset Key**: Hold down the key located at *K00*, commonly programmed as *Esc* while plugging in the keyboard.

See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).