Skip to content

Instantly share code, notes, and snippets.

@twalker
Last active October 7, 2024 02:40
Show Gist options
  • Select an option

  • Save twalker/72ba828f2cb76f5e460c047719ae729c to your computer and use it in GitHub Desktop.

Select an option

Save twalker/72ba828f2cb76f5e460c047719ae729c to your computer and use it in GitHub Desktop.

Revisions

  1. twalker revised this gist Oct 7, 2024. No changes.
  2. twalker revised this gist Oct 7, 2024. 1 changed file with 3 additions and 0 deletions.
    3 changes: 3 additions & 0 deletions getting-cg-started-lily58.md
    Original file line number Diff line number Diff line change
    @@ -1,3 +1,6 @@
    ![lily58_base](https://gist.github.com/user-attachments/assets/65cdead5-3c90-4ad5-934b-1ed2c44718ec)
    ![lilly58_2](https://gist.github.com/user-attachments/assets/6d63cc6f-62ef-4ff9-9655-d0ac6696281e)
    ![lily58_1](https://gist.github.com/user-attachments/assets/97b57c68-68f8-45f1-8045-67563a057cb1)
    ## Getting Started

    Enclosed is your custom built Lily58 keyboard.
  3. twalker created this gist Oct 7, 2024.
    46 changes: 46 additions & 0 deletions getting-cg-started-lily58.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,46 @@
    ## Getting Started

    Enclosed is your custom built Lily58 keyboard.

    1. Connect the halves together with the TRRS cable.
    2. Connect a USB-C cable between the left half and your computer.
    4. Type.

    The [default Lily58 keymap](https://github.com/vial-kb/vial-qmk/blob/vial/keyboards/lily58/rev1/keymaps/vial/keymap.c#L34-L90) has been flashed onto the keyboard.


    ## The hardware

    * Hot swappable MX switch sockets
    The switches can be changed without any desoldering.
    * RP2040 Pro Micro 16MB USB-C microcontrollers.
    * Clones of Holy Panda key switches
    * JA/EN Keycaps.
    The keycaps can be be replaced with any other MX compatible keycaps--a keycap/switch pulling tool is recommended.
    * Lily58 designed by kata0510--a software engineer in Japan.
    - [PCB source](https://github.com/kata0510/Lily58)
    - [Keyboard firmware source in vial-qmk](https://github.com/vial-kb/vial-qmk/tree/vial/keyboards/lily58). This is a fork of [QMK](https://qmk.fm/) that provides [an app to update the keymap in realtime](https://get.vial.today/).
    * [3D Printed Case]([https://www.printables.com/model/93298-lily58-case/comments/2036007](https://www.thingiverse.com/thing:5386099).

    The keyboard is high profile. If you normally rest your palms when typing, the [Fellowes Crystals Gel wrist rests](https://www.amazon.com/Fellowes-Crystals-Gel-Flex-Rest/dp/B000YBZZU0/ref=sr_1_1?crid=3D9RC0A9S4BH8&keywords=Fellowes+Crystals+Gel+Flex+Rest&qid=1645151479&s=electronics&sprefix=fellowes+crystals+gel+flex+rest+%2Celectronics%2C196&sr=1-1) work well with split keyboards--[here's a cheaper option](https://www.amazon.com/LetGoShop-Heart-Shaped-Translucence-Ergonomic-Effectively/dp/B07C1VW6N1/ref=slsr_d_dpds_fsdp4star_fa_xcat_dpricet2_d_sccl_2_4/135-8042523-9794744?pd_rd_w=6vkAm&content-id=amzn1.sym.2607c024-56d9-4ea9-861f-edcf1be019b4&pf_rd_p=2607c024-56d9-4ea9-861f-edcf1be019b4&pf_rd_r=TZMHEJ1T8NG5BW1GRVTZ&pd_rd_wg=H4wBx&pd_rd_r=d974ec93-ab5a-4e63-bb03-a72043fe1a99&pd_rd_i=B01DKCPC16&th=1).

    ## The software

    * [QMK](https://qmk.fm/) open source firmware
    * [Getting started with Vial QMK](https://get.vial.today/) -- install an app that provides a UI to update the keymap in real-time.

    ## Training sites

    * [keybr](https://www.keybr.com/) to learn key positions and reduce errors with adaptive machine learning.
    * [monkeytype](https://monkeytype.com/) to practice prose, symbols, and numbers (extremely configurable -- check the **funbox**).
    * [typing.io](https://typing.io/) to practice coding.

    ### Videos

    * [Are Split Keyboards Better For Ergonomics?](https://www.youtube.com/watch?v=1C2bJkzIaPE&ab_channel=BenVallack)
    * [Tools & Tips For Learning A New Keyboard Layout (Or How To Type Faster!)](https://www.youtube.com/watch?v=sI-a64EVPPU&t=253s&ab_channel=BenVallack)
    * [How to use an ergonomic keyboard in 5 easy steps](https://www.youtube.com/watch?v=PgYRIJsWne0&ab_channel=DygmaLab)

    ## Support

    Most parts of the keyboard (switches, keycaps, case, etc) can be replaced or swapped with a different part you may like better. If you have any questions on using, programming, or any want to change any aspect of the keyboard, contact me at [email protected]