Skip to content

Commit

Permalink
update readme and key mapping names for SVG
Browse files Browse the repository at this point in the history
  • Loading branch information
280Zo committed Nov 7, 2024
1 parent c179913 commit 9d8c3b5
Show file tree
Hide file tree
Showing 4 changed files with 25 additions and 18 deletions.
3 changes: 2 additions & 1 deletion .github/workflows/draw_keymaps.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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() {
Expand Down
10 changes: 7 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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

Expand Down
28 changes: 14 additions & 14 deletions config/charybdis.keymap
Original file line number Diff line number Diff line change
Expand Up @@ -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
>;
};
Expand All @@ -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
>;
};
Expand Down
2 changes: 2 additions & 0 deletions keymap-drawer/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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: []

0 comments on commit 9d8c3b5

Please sign in to comment.