mirror of
https://github.com/ClaytonWWilson/miryoku_zmk.git
synced 2025-12-13 17:58:47 +00:00
76 lines
3.8 KiB
Org Mode
76 lines
3.8 KiB
Org Mode
# Copyright 2022 Manna Harbour
|
|
# https://github.com/manna-harbour/miryoku
|
|
|
|
* Miryoku ZMK Quickstart Guide [[https://raw.githubusercontent.com/manna-harbour/miryoku/master/data/logos/miryoku-roa-32.png]]
|
|
|
|
A personalised build of [[https://github.com/manna-harbour/miryoku_zmk][Miryoku ZMK]] can be [[#initial-setup][set up]], [[#build][built]], [[#download][downloaded]], and [[#flash][flashed]] onto your keyboard in a few minutes without installing any software or editing any files.
|
|
|
|
|
|
** Initial Setup
|
|
|
|
- [[https://github.com/signup][Create a GitHub account]].
|
|
- [[https://github.com/login][Login to GitHub]].
|
|
- Visit https://github.com/manna-harbour/miryoku_zmk.
|
|
- Press the ~Fork~ button in the top right.
|
|
#+html: <img src="https://docs.github.com/assets/cb-6294/images/help/repository/fork_button.jpg" width="640"/>
|
|
- Visit https://github.com/?q=miryoku_zmk.
|
|
- Select your fork of ~miryoku_zmk~ from the list on the left.
|
|
- Select the ~Actions~ tab.
|
|
#+html: <img src="https://docs.github.com/assets/cb-13492/images/help/repository/actions-tab.png" width="640"/>
|
|
- Press the ~I understand my workflows, go ahead and enable them~ button.
|
|
|
|
|
|
** Build
|
|
|
|
Start here to build new firmware after completing the [[#initial-setup][initial setup]].
|
|
|
|
- Visit https://github.com/?q=miryoku_zmk.
|
|
- Select your fork of ~miryoku_zmk~ from the list on the left.
|
|
- Press the ~Fetch upstream~ button in the top right.
|
|
#+html: <img src="https://docs.github.com/assets/cb-33284/images/help/repository/fetch-upstream-drop-down.png" width="640"/>
|
|
- Press the ~Fetch and merge~ button in the popup if it is enabled.
|
|
#+html: <img src="https://docs.github.com/assets/cb-128489/images/help/repository/fetch-and-merge-button.png" width="640"/>
|
|
- Select the ~Actions~ tab.
|
|
#+html: <img src="https://docs.github.com/assets/cb-13492/images/help/repository/actions-tab.png" width="640"/>
|
|
- Select ~Build Inputs~ from the ~Workflows~ list on the left.
|
|
- Press the ~Run workflow~ button on the right.
|
|
#+html: <img src="https://docs.github.com/assets/cb-57703/images/actions-workflow-dispatch.png" width="640"/>
|
|
- Fill out the fields in the popup as desired. See the [[https://github.com/manna-harbour/miryoku_zmk/#options][Options]] documentation for details.
|
|
#+html: <img src="images/fields.png" height="640"/>
|
|
- Press the ~Run workflow~ button at the bottom of the popup.
|
|
#+html: <img src="https://docs.github.com/assets/cb-22055/images/actions-manually-run-workflow.png" width="640"/>
|
|
- Wait for the workflow run to complete.
|
|
|
|
|
|
** Download
|
|
|
|
Start here to download previously [[#build][built]] firmware.
|
|
|
|
- Visit https://github.com/?q=miryoku_zmk.
|
|
- Select your fork of ~miryoku_zmk~ from the list on the left.
|
|
- Select the ~Actions~ tab.
|
|
#+html: <img src=https://docs.github.com/assets/cb-13492/images/help/repository/actions-tab.png width=640/>
|
|
- Select the workflow run from the list.
|
|
#+html: <img src=https://docs.github.com/assets/cb-106784/images/help/repository/run-name.png width=640/>
|
|
- Select the artifact at the bottom.
|
|
#+html: <img src=https://docs.github.com/assets/cb-19656/images/help/repository/artifact-drop-down-updated.png width=640/>
|
|
- Wait for the download to complete.
|
|
- Unzip the downloaded zip file.
|
|
|
|
|
|
** Flash
|
|
|
|
Start here to flash previously [[#download][downloaded]] firmware.
|
|
|
|
The downloaded zip will contain a ~uf2~ firmware file. For split keyboards the zip will contain separate firmware files for the left and right sides, and the following steps should be performed for each side.
|
|
|
|
- Connect the keyboard to the computer with a USB cable.
|
|
- Double tap the reset button rapidly (two presses within half a second). The keyboard will appear to the computer as a USB mass storage device.
|
|
- Copy the firmware file to the device. The keyboard will reset and the device will be removed.
|
|
|
|
|
|
**
|
|
|
|
[[https://github.com/manna-harbour][https://raw.githubusercontent.com/manna-harbour/miryoku/master/data/logos/manna-harbour-boa-32.png]]
|
|
|