From 9d8c3b5fd5c6eb5c794577d7b3c57a398fd3c98d Mon Sep 17 00:00:00 2001 From: AJ <1754228+280Zo@users.noreply.github.com> Date: Wed, 6 Nov 2024 21:34:37 -0800 Subject: [PATCH] update readme and key mapping names for SVG --- .github/workflows/draw_keymaps.yaml | 3 ++- README.md | 10 +++++++--- config/charybdis.keymap | 28 ++++++++++++++-------------- keymap-drawer/config.yaml | 2 ++ 4 files changed, 25 insertions(+), 18 deletions(-) diff --git a/.github/workflows/draw_keymaps.yaml b/.github/workflows/draw_keymaps.yaml index ade4b8c7..ab7941d9 100644 --- a/.github/workflows/draw_keymaps.yaml +++ b/.github/workflows/draw_keymaps.yaml @@ -170,7 +170,8 @@ jobs: "&shit": "SHIT SUDO", "&new_dir": "NEW DIR", "&py_iter": "PYTHON LOOP", - "&js_iter": "JS LOOP" + "&js_iter": "JS LOOP", + "&studio_unlock": "ZMK Studio" } run: | get_args() { diff --git a/README.md b/README.md index c306173f..89b54e31 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ There are a few things to note about how the pre-built firmware is configured: - To add support for the PMW3610 low power trackball sensor, badjeff's [zmk-pmw3610-driver](https://github.com/badjeff/zmk-pmw3610-driver), [ZMK Input Behavior Listener](https://github.com/badjeff/zmk-input-behavior-listener?tab=readme-ov-file), and [ZMK Split Peripheral Input Relay](https://github.com/badjeff/zmk-split-peripheral-input-relay) modules are included in the firmware. - eigatech's [zmk-configs](https://github.com/eigatech/zmk-config?tab=readme-ov-file) played a major role in getting badjeff's drivers and modules fully configured and are a great resource - A separate branch builds the Bluetooth/USB firmware using [inorichi's driver](https://github.com/inorichi/zmk-pmw3610-driver?tab=readme-ov-file) as an alternative to badjeff's driver. -- Pete Johanson (Creator and lead of the ZMK firmware) developed a feature ([pointers-move-scroll](https://github.com/zmkfirmware/zmk/pull/2027)) that allows mouse keys to move and scroll. A successor feature ([pointers-with-input-processors](https://github.com/zmkfirmware/zmk/pull/2477)) was then developed that allows more flexibility. This firmware is what will eventually be merged into the main ZMK repo, and it's what is used in this repo. Although it's not guranteed to be stable, it hasn't caused any noticible issues. That being said, if you'd prefer to use pointers-move-scroll which is in a stable state, you can update the west.yaml and adapt the config files accordingly. +- Pete Johanson (Creator and lead of the ZMK firmware) developed a feature ([pointers-move-scroll](https://github.com/zmkfirmware/zmk/pull/2027)) that allows mouse keys to move and scroll. A successor feature ([pointers-with-input-processors](https://github.com/zmkfirmware/zmk/pull/2477)) was then developed that allows more flexibility. This feature is what will eventually be merged into the main ZMK branch, and it's what is used by this repo to build the firmware. Although it's not guranteed to be stable, it hasn't caused any noticible issues. That being said, if you'd prefer to use pointers-move-scroll which is in a stable state, you can update the west.yaml and adapt the config files accordingly. ## Flashing the Firmware @@ -75,6 +75,10 @@ Here are a few tips for a quick start: [ZMK Studio](https://zmk.studio/) allows users to update functionality during runtime. It's currently in beta, but the physical layout and updated config files are included in the BT/USB firmware for testing. The dongle firmware does not have this integration at the moment. +To change the visual layout of the keys, the physical layout must be updated. This is the charybdis-layouts.dtsi file, which handles the actual physical positions of the keys. Though they may appear to be similar, this is different than the matrix transform file (charybdis.json) which handles the electrical matrix to keymap relationship. + +To easily modify the physical layout, or convert a matrix transform file, [caksoylar](https://github.com/caksoylar/zmk-physical-layout-converter) has built the [ZMK physical layouts converter](https://zmk-physical-layout-converter.streamlit.app/). + For more details on how to use ZMK Studio, refer to the [ZMK documentation](https://zmk.dev/docs/features/studio). ### Keymap GUI @@ -127,10 +131,10 @@ This repo uses the excellent work of caksoylar's [Keymap Drawer](https://keymap- ## Upcoming ZMK Features -ZMK is actively being developed and there are a few features that will be added to these builds as soon as they are released. +ZMK is actively being developed and there are a few features that will be added to these builds if/when they are approved. -- Mouse move and scroll support - [in draft](https://github.com/zmkfirmware/zmk/pull/2477) - Layer Lock - [Open PR](https://github.com/zmkfirmware/zmk/pull/1984) +- Unicode Support - [Issue](https://github.com/zmkfirmware/zmk/issues/232) ## Credits diff --git a/config/charybdis.keymap b/config/charybdis.keymap index 421c5646..a25915fd 100644 --- a/config/charybdis.keymap +++ b/config/charybdis.keymap @@ -183,18 +183,18 @@ NUM { bindings = < -&none &none &none &none &none &none &kp SLASH &hm F7 N7 &hm F8 N8 &hm F9 N9 &hm F10 MINUS &none -&kp TAB &none &none &none &kp BACKSPACE &none &kp ASTRK &hm F4 N4 &hm F5 N5 &hm F6 N6 &hm F11 PLUS &none +&trans &none &none &none &none &none &kp SLASH &hm F7 N7 &hm F8 N8 &hm F9 N9 &hm F10 MINUS &none +&trans &none &none &none &kp BACKSPACE &none &kp ASTRK &hm F4 N4 &hm F5 N5 &hm F6 N6 &hm F11 PLUS &trans &none &none &none &none &none &none &kp DOT &hm F1 N1 &hm F2 N2 &hm F3 N3 &hm F12 EQUAL &none - &trans &none &trans &kp N0 &trans + &none &none &trans &kp N0 &trans >; }; NAV { bindings = < &none &none &none &none &none &none &none &kp LS(LC(H)) &kp LS(LC(J)) &kp LS(LC(K)) &kp LS(LC(L)) &none -&trans &trans &trans &trans &trans &trans &VSplit &kp LEFT_ARROW &kp DOWN &kp UP &kp RIGHT_ARROW &none -&none &none &none &none &trans &none &HSplit &kp HOME &kp PG_DN &kp PG_UP &kp END &none +&trans &trans &trans &trans &trans &none &VSplit &kp LEFT_ARROW &kp DOWN &kp UP &kp RIGHT_ARROW &none +&none &none &none &none &none &none &HSplit &kp HOME &kp PG_DN &kp PG_UP &kp END &none &none &none &trans &trans &trans >; }; @@ -210,27 +210,27 @@ GAME { bindings = < -&kp N1 &kp TAB &kp Q &kp W &kp E &kp R &none &none &none &none &none &to 0 +&kp N1 &kp TAB &kp Q &kp W &kp E &kp R &none &none &none &none &none &none &kp N2 &kp LCTRL &kp A &kp S &kp D &kp F &none &none &none &none &none &none &kp N3 &kp LSHFT &kp Z &kp X &kp C &kp V &none &none &none &none &none &none - &trans &kp SPACE &kp LEFT_ALT &none &none + &none &kp SPACE &kp LEFT_ALT &none &none >; }; PHOTOS { bindings = < -&trans &kp LA(LC(LS(Z))) &kp LA(LC(LS(E))) &kp LA(LC(LS(A))) &kp LA(LC(LS(S))) &kp LA(LC(LS(B))) &none &none &none &none &none &trans -&kp LC(LA(E)) &kp LEFT &kp DOWN &kp UP &kp RIGHT &kp LCTRL &none &none &none &none &none &none -&kp LS(DELETE) &kp LA(LS(A)) &kp LA(KP_N1) &kp LA(KP_N2) &kp LA(KP_N3) &none &none &none &none &none &none &to 0 - &trans &none &trans &trans &trans +&trans &kp LA(LC(LS(Z))) &kp LA(LC(LS(E))) &kp LA(LC(LS(A))) &kp LA(LC(LS(S))) &kp LA(LC(LS(B))) &none &none &none &none &none &none +&kp LC(LA(E)) &kp LEFT &kp DOWN &kp UP &kp RIGHT &kp LCTRL &none &none &none &none &none &trans +&kp LS(DELETE) &kp LA(LS(A)) &kp LA(KP_N1) &kp LA(KP_N2) &kp LA(KP_N3) &none &none &none &none &none &none &none + &trans &trans &trans &trans &trans >; }; EXTRAS { bindings = < -&kp C_SLEEP &shrug &lgtm &gcm &none &kp C_BRIGHTNESS_INC &bt BT_SEL 0 &bt BT_SEL 1 &bt BT_SEL 2 &bt BT_SEL 3 &none &kp C_AL_COFFEE -&kp C_POWER &shit &py_iter &js_iter &none &kp C_BRIGHTNESS_DEC &out OUT_TOG &kp C_PREVIOUS &kp C_PLAY_PAUSE &kp C_STOP &kp C_NEXT &none -&bt BT_CLR &none &none &none &none &clip_hist &new_dir &kp C_VOLUME_DOWN &kp C_VOLUME_UP &kp K_MUTE &kp PRINTSCREEN &studio_unlock +&kp C_POWER &shrug &lgtm &gcm &none &kp C_BRIGHTNESS_INC &bt BT_SEL 0 &bt BT_SEL 1 &bt BT_SEL 2 &bt BT_SEL 3 &out OUT_TOG &bt BT_CLR +&kp C_SLEEP &shit &py_iter &js_iter &none &kp C_BRIGHTNESS_DEC &none &kp C_PREVIOUS &kp C_PLAY_PAUSE &kp C_STOP &kp C_NEXT &none +&kp C_AL_COFFEE &none &none &none &none &clip_hist &new_dir &kp K_MUTE &kp C_VOLUME_DOWN &kp C_VOLUME_UP &kp PRINTSCREEN &studio_unlock &none &none &none &none &none >; }; diff --git a/keymap-drawer/config.yaml b/keymap-drawer/config.yaml index 91b842bc..ea73588c 100644 --- a/keymap-drawer/config.yaml +++ b/keymap-drawer/config.yaml @@ -237,6 +237,8 @@ parse_config: LA(KP_N2): "PENDING" LA(KP_N3): "ACCEPT" F12: "DEV TOOLS" + BRIGHTNESS INC: "BRIGHT ▲" + BRIGHTNESS DEC: "BRIGHT ▼" zmk_combos: {} zmk_preamble: "#define KEYMAP_DRAWER" zmk_additional_includes: []