# Copyright 2021 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 [[https://github.com/manna-harbour/miryoku_zmk#fields--options][described]].
- 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]]