[Zmk] Keymap Editor를 사용해보자

ㅇ이응이ㅇ · 2025.05.09 17:21:24

7999f473c6876bf123ea8fe2469c701fdff09e92dbc7f893bf8068b1c1e872cb205e4a3e6ea19b431380b7732181210090eed6

나도 zmk는 완전초보지만 여기 zmk키보드 쓰면서 깃헙이나 키맵에디터는 어려워보여서 고급기능을 사용하지 못하는 사람이 종종 보여서 쌩초보 기준 키맵에디터 사용 가이드를 써보려고함.

https://m.dcinside.com/board/mechanicalkeyboard/2153556

[Vial] 처음부터 알아보자. - 기계식키보드 마이너 갤러리

[시리즈] Vial 응애편 · [Vial] 처음부터 알아보자. · [Vial] 세팅과 space fn에 대해 알아보자 · [Vial] 탭댄스에 대해 알아보자 · [Vial] Key overrides에 대해 알아보자

m.dcinside.com

그리고 vial입문서도 열심히 써놨으니 봐주세요

키맵에디터는 키맵 수정을 GUI로 구현해서 코드뭉치 수정하는거에 비해 유저친화적으로 매핑을 도와주는 웹기반 툴임

웹기반 툴이라고 해서 유선의 qmk의 via나 vial처럼 실시간으로 매핑이 적용되는것은 아니고 gui로 손쉽게 바꾼 키맵을 컴파일해주는걸 도와주는 툴이기 때문에 파일은 유선연결해서 수동으로 다시 적용시켜줘야함

물론 방법은 뒤에 다 설명할것임

즉, 키맵에디터는 실시간 매핑 적용은 아니다라는것만 미리 알아두고 가면됨

한번 세팅해두면 그 뒤에 뭐 할거 없고 생각보다 안어려우니 그대로만 따라해보셈

진짜 첨부터 모든 과정을 다 첨부했으니 영어사이트라고 겁먹지말고 같이 도전ㄱㄱ

09e88474b3826d85239b81e1359c701ea8ac9958c41cd1136d8974169d4643caa70634d8b7e541286f3f3aef0b3b2e67c2cc1b

https://github.com

일단 1단계,,

github에 가입해야함

관련업계가 아닌이상 깃을 사용하지 않는 사람이 많기때문에 여기서부터 생소하고 엥? 할수있음..

두려워하지말고 회원가입부터 하자

메일만 넣으면 끝이라 뭐 복잡할것도 없음

인증번호 받고 가입해주면 끝!

나도 키붕새들과 함께 처음부터 가입해서 같이 해보겠음

0ee9807fbd811df523ed8590439c706c504d4fe77073144dd6949ac1d95933af9fb26f72e1f143b09e877ce0c5407b5c1f6aa0

가입성공하면 메인페이지 이렇게 뜰것임

지금 여기서 뭐 할건 없으니 가입됐구나~ 하고 패스

0898f370b68668fe23e6f7e7449c701eaf79b06f6bd0af498cc7ed055c7dbbf123162b86ed999df30395f0b73d072c339d498596

zmk, 스플릿을 입문하고 이 글을 볼 사람이면 기성품이나 공제품, 혹은 유명한 오픈소스를 기반으로 만든 키보드를 쓰고있을거임

자작은 아닐거란 말이지

그럼 해당 키보드의 repository가 다 공개되어있음

줄여서 리포라고 하겠음

리포가 뭐냐면 그냥 저장소같은거라 생각하면 됨

09ef8476b1816ef623ef8190419c701caf3da9f7ed84d28af5c45fb9dd20c50c60554e8e98a5c998b8be17f8ba828277aa9c1b

위처럼 코르네가 될수도 있고 토템이 될수도 있고 자기 키보드의 리포를 찾아보면 굉장히 많이 나올거임

원본 리포를 찾아가도 좋고 이미 어느정도 세팅이 된 사람의 키맵을 베이스로 수정해보고 싶다 하면 그걸 찾아가도 좋음

759ef605c6846ef423ef83ed309c701ede50d04fbbafc2b108256f09f085605211640b06ebe804523ea0f18df77f83683c2582

찾았으면 오른쪽 위 fork화살표를 누르고 create new fork를 누름

759f8274b4f76afe23ecf593309c701cda16968895b4257f1d2af35e96014bcd0fb063b90bd787748222fce31fca18dbedc18327

그럼 어찌고 저찌고 나오는데 그냥 리포주소 이름이나 주석같은거 쓰는곳임

특별히 만질거 없음.

그냥 오른쪽 아래 생성ㄱㄱ

7ce48703b3831d87239cf4e44f9c7068e4ac22ba9d1dece45dbe7be9d77ec95dd68804e2510ca94154c30f79331d71fa659af6

이제 내 리포를 들어가봄

오른쪽 위에 아바타같은거 누르면 your repesitories나오는거 클릭

7f998775b2801b8723e6f091409c70646972fc584979ee202ad8d158ee0a263b08f1a99a6bcc4b9fe83574966d105e4c677a9b

그럼 여기 내가 포크한 리포가 쫙 뜸

님들은 자기꺼 하나만 했을태니 하나만 뜰거임

74e98104b580698723e6f0e3379c706dfb07aff84d9e0394dc871d831ff20ae979bd4dcafca3cdde6eacb95ad4ebfd0c932e38

이제 이 리포는 제것입니다.

맘껏 수정 가능함

키맵파일을 찾아가보면 이렇게 좌르륵 나옴

이 외계어들은 뭐지?

qmk를 만져봤던 사람이라면 아주 익숙할것임

원래 이걸 직접 수정하는 방법이 가장 기초적이고 원시적인 방법임

그럼 내가 바꾸려는 키코드를 공부해서 일일히 해당 위치에 대치해서 넣고

콤보니 탭댄스니 기타 기능들 다 정의하고 인수할당하고 개지롤하면서 세팅하고 오류뜨면 해결하고 해야하지만 우린 그런거 할줄 모름!

할줄 안다고 해도 그게 싫어서 키맵에디터를 쓰려는것이기 때문에 일단 구경만 하고 넘어가면 됨

키맵에디터를 이용해서 수정하면 결국 이 키맵파일이 자동으로 바뀌게 될것임.

그래도 경로는 알아둬야 나중에 키고수가 되어서 코드추가로만 가능한 기능을 쓸때 이곳을 다시 찾아올수있음,,

0f988373b5f060f6239c8e914e9c701e8b58f67cb2981d471dc98665df8f089034f3fa51965d3ed82adb289cf5dc7bf8bea2fb

이제 키맵 에디터로 가기전에 깃헙에서 한가지를 더 해줘야함

내 리포에 들어간 뒤에 액션이라는 탭을 클릭함

79ea8074b0f11af4239bf594359c706be6f70d4a825e77f71b78f9459daba250b3e157520a0804ac61f353e2a403c63528b71a

그럼 최초 입장시 어찌고 확인 문구가 뜨는데 이걸 눌러놔야함

75e48972b280198223e982e3329c701931ba9e5079ef83b3578ba8b8946890c4aed32b0eadc9c62c408a16e417eb47a0d431a4

누르면 아직은 아무런 workflow가 없다!

이 액션이 그래서 몬데?

간단하게 이곳에서 컴파일을 우리 대신 해준다고 보면댐

원래 qmk를 쓴다고하면 키맵을 수정하고 저장해서 qmk msys를 키고 경로 찾아가서 컴파일 명령어 쳐야 컴파일이 되는데 zmk에서 깃헙을 사용하면 이 모든과정을 지가 자동으로 해줌!

이따 다시 찾아올거니 저 화면 뜨는거 확인하고 이제 키맵에디터로 고고

09e48977c6f11bf323e78590379c701931e14c72019293a63829bb8ac4963a179d8c853d57726226e973e68b3cedcb8e9c382f

7d9ef407c0f11b80239e8ee1339c7065a3ae5e1cbecf56c8f0da7e3d5ec94f4a5788d7651854ba66413cae0fdc075120a596ff

https://nickcoutsos.github.io/keymap-editor/

키맵에디터에 들어가면 뭐가 여러개 뜨는데 여기서 깃헙을 누르면 됨

그럼 로그인하라고 뜨는데 로그인눌러주고

7c99f372b58368f523e784e6479c7019ecf53cea0770142488145665842a02d40b4a07852104bab6ca895d59a5901cf67eec20d9

뭐라뭐라 경고창이 뜸

읽어보자

몬소린지 모르겠다고?

7e9f8400b5f06ef6239e8e97359c701b9bf99ccfce06438288bedc76c97eaf9a4260c36c338460a3a1dcfcecdf0a5352eabcaa

별거 아니고 All리포를 선택하지말고 only select리포를 클릭해서 진행하라는 뜻.

내가 수정하고싶은 키보드의 리포를 선택한 뒤에 install을 누르면 됨

totem으로 진행해보게씀

089ef171c3f71a80239af0e7329c701bc0c8d6afd5deab0f452a7583af22f337ccdac5aaa61fe80772a91414fba39a009453c8

짜잔~

그럼 이렇게 내 리포에 있는 토템키맵이 키캡에디터에 불러와짐

이제 코드덩어리를 수정하는 대신 이 리모콘모양의 웹기반 툴을 이용하여 키맵을 바꾸면됨

zmk는 처음이기도 하고 생소한게 많을탠데 각 기능을 자세히 설명하려면 또 너무 길어지기 때문에 기능 설명이나 실전예시같은건 따로 글을 쓰고 여기 링크를 추가하겠음

키맵에디터에서도 vial에서 쓰던 기능들은 거의다 된다고 보면되고 오히려 더 좋은점도 있기 때문에 기능이 부족하면 어쩌지? 라는 걱정은 안해도 됨

0e9ff277c18019fe23e787e5409c706fedc304e4f1844081b4a9de5378f13fa89825ea295a79317020850a0e6dd98eae62d841

일단 간단하게 기본키 하나만 바꿔보자

바꾸고싶은 키 클릭하면 위 behavior라는곳에 kp라고 나와있는데 이건 qmk의 kc같은거임.

키코드같은것이니 저기서 원하는 키 아무거나 선택하고 오케이!

위에 보면 모디키조합을 체크박스 선택해서 조합키 설정도 매우 간편하게 가능함

7d998275c6f16bf323e7f2e0349c70196971811c5c02dba6c6469a52217e3932f58395e57742e94fc9021bdc6d132271a26caa

이렇게 키를 바꿔서 변경사항이 생기면 페이지 좌측 상단 save버튼이 초록색으로 활성화됨

이걸 눌러줌

0bebf47fbdf469f323e9f593339c706cab826dfbad766a7223e4db0fb5959b1336621c6902914d7e78ec0e5c535a7a45843a

그럼 머라머라 뜨는데 저 칸은 비고란 같은거니까 안쓰고 넘어가도 됨

뭐 적어두면 나중에 식별하기 편하니까 원하는거 적어도 됨

암튼 commit눌렀으면

7deef470bdf41cf023ec81e0329c70642592a8bc8b92b4cd11fa90a8e537d5cd5cca8d20b540e2ecf27643e90baa41222d6e

이렇게 뺑글뺑글 뭐가 돌아가면서 실행중이란듯이 박스가 하나 뜸

이걸 눌러보자

099ff300bc821b8323e7f3e2469c706e00cc882e9755a65408efc938cecf2cf74f0bb3d083f733a419c1afbe2380250fb339d7

띠용

이걸 누르면 아까 본 액션페이지로 넘어옴

방금 내가 키맵에디터에서 세이브한 키맵을 기반으로 컴파일을 자동으로 하는거임

스플릿키보드라 0/2로 2개의 파일이 나올것임

7f9e837fb781698723998fe6449c7065dbc8d62f4fceea443ece6a86f82dcfbc83094a77c00c5ecfb7d54d3b53e2a1178c2e0f

저렇게 키맵에디터 버튼 눌러도 되고 그냥 깃헙 액션탭 눌러도 똑같이 들어갈수 있음

789cf573c084198323eb8e93479c70685d231d70ce304b0d0d748f017dada9e35ea7440d66dfee7c05de4226316aaa203f4df1

웹에서 작동하는거라 시간이 2~3분정도 걸림

딴짓하다 와보면 완성되어있음

759b8077b0f41a8723e98fe6409c706e82da25d3a35e0dcb2233dc9529980a095c639fa41fbc98aa543a1ab7a919cd5bdf97e3

들어가면 아래 firmware가 나왔다!

모두 초록불이 뜨고 파일이 나오면 성공

뭔가 문제가 생기면 빨강색 뜨면서 오류뜰것임..

근데 키맵에디터만 만지면 오류 뜰 일이 거의 없음

충돌생길만한게 있으면 키맵에디터 툴 안에서도 알려줌

7aebf57fc6851b8223eb87ec419c706d9339b4eabe650aebf3228279e7b1832a4f6cdf331bac940d99efca820cace193f689

암튼 우린 성공했으니 저걸 누르면 압축파일이 다운됨

7ce5f575b78b6a8523edf290339c706e815744518de582bff9629f690a5ae707a3f281b2d93c200b162ae412eda2ac3a2c72

압축풀면 좌우 펌웨어 uf2파일이 한짝씩 나옴

본인이 스플릿이 아니라면 1개가 나왔을거임

이제 키보드에 선을 연결하고 리셋버튼을 두번 따닥! 누르면 usb또롱 소리가 나면서 외장하드 나오듯이 파일창이 하나 팝업됨

거기다가 방금 나온 uf2 파일을 드래그엔 드랍으로 옮겨주면 자동으로 flash됨

당연히 좌측에는 좌측 펌웨어를 넣어야함,,

그리고 일반적으로는 좌측이 마스터니까 좌측부터 넣고 다음에 우측을 넣자

이제 당신은 당당한 키맵에디터 사용자!

키맵에디터 내의 behavior로 탭댄스나 콤보 등 고급기능을 사용하는건 다음 글에서 다루도록 하겠음

(언제쓸지몰름..)

이제 키맵에디터 사용법은 익혔으니 혼자 이것저것 만져보는것도 재밌음ㅋㅋ

최대한 자세히 모든 과정을 스샷으로 찍었는데 그래도 모르겠으면 댓글달아주셈..

그리고 이것은 나도 누비입장에서 입문용으로 작성한 글이기 때문에 zmk고수들은 중간과정에서 빼먹은거나 잘못된게 보이면 알려주심 감사하겟슴

번호	말머리	제목	글쓴이	작성일	조회	추천
-	설문	내 돈 투자하고 싶게 만드는 CEO상 스타는?	운영자	26/03/02	-	-
-	AD	가격 오르기 전!! 노트북 기획전!!	운영자	26/02/12	-	-
67	공지	유용할수도 있는 링크들 (25.05.13수정) [5]	*천둥신님*	22.01.09	23894	7
1273	공지	스압] 인체공학적 편의성의 끝은 어디인가? [8]	ㅇㅇ(121.184)	23.09.05	8797	51
8823	공지	신문고	ㅇㅇ(211.206)	25.10.17	398	0
12869	질문	치어즈 40 써보신분있나요?! [4]	부부붐이	02:15	47	0
12868	일반	카리브디스 추천 받아서 고민 중인데	갈르셈단(49.164)	03.03	57	0
12867	일반	스플릿 키보드를 속기 키보드로 쓸수있나요? [3]	갈르셈단(222.98)	03.03	81	1
12866	일반	아 카리브디스 망할 키보드 [1]	ㅇㅇ	03.03	67	0
12865	일반	키부두 완 [1]	Ksty	03.03	91	0
12864	일반	크아악 내 삼하가!!! [1]	천둥신님	03.03	97	0
12863	일반	무선 토템 하나 산다	ㅇㅇ(221.163)	03.03	48	0
12862	일반	mjf방식 pa12 제품 도색 문의 [2]	사진이랑두꺼비	03.03	55	0
12861	일반	GMK70 팔 사람?	핫아이스크림	03.03	51	0
12860	일반	klp lame fkcaps 공식발표 [3]	ㅇㅇ	03.03	144	0
12859	일반	키웰구조 처음 써본 감상 [1]	갈르셈단(211.236)	03.03	91	0
12858	일반	urchin 주문완 [5]	ai4bio	03.03	122	0
12857	일반	입문하려는데 4x6배열 파는 사람 있나? [6]	갈르셈단(211.36)	03.03	111	0
12856	질문	갈르셈 입문을 34key로 하는건 에바인가 [10]	ai4bio	03.03	160	0
12855	일반	UPS가 앙증맞은 찐빠를 저질렀네 허참.. [4]	천둥신님	03.03	126	0
12854	일반	알1리에 스플릿키보드가 좀 줄어든거 같은데 [3]	갈르셈단(218.55)	03.03	138	0
12853	일반	유주키캡 새프로파일 유출이있네 [7]	ㅇㅇ(220.121)	03.03	161	0
12852	일반	적응이 너무 빡세다 [3]	갈르셈단(211.114)	03.02	153	0
12851	질문	totem rgbled widget 빌드 에러 질문 [1]	갈르셈단(222.99)	03.02	83	0
12850	일반	이런 키보드 엄지로 키2개 동시에 누르기 가능? [5]	갈르셈단(222.98)	03.02	184	0
12849	질문	스윕 아이패드랑 연결하는데… [4]	갈르셈단(14.34)	03.02	111	0
12848	일반	뜌따이... 납땜기판 처음 해봐.... [4]	유부말이	03.02	223	0
12847	일반	스플릿 키보드 행 눌림 문제 도와주십셔 ㅠㅠㅠ [4]	갈르셈단(121.155)	03.02	172	0
12846	일반	펀딩 키보드 배송올때까지 숨 참음 [4]	ㅇㅇ(118.235)	03.01	213	1
12845	일반	안녕하세요 질문 있습니다!! [4]	갈르셈단(183.109)	03.01	130	0
12844	일반	Dygma 이놈들은 걍 qmk 딸깍이나 하지 [2]	별그림자	03.01	171	0
12843	질문	via vial qmk 질문드립니다. [7]	바이티	03.01	126	0
12841	일반	요즘 생각하는건데 zmk 동글 캐릭터랑 콜라보해서 [4]	갈르셈단(112.164)	03.01	141	0
12840	일반	배터리 배송 완전 오래걸리네.... [5]	냐랄라	03.01	155	0
12839	일반	어고독스 키보드는 은근 비싸넹 [2]	갈르셈단(182.31)	03.01	265	0
12838	질문	속기 배열을 Plover로 이식했는데 스플릿키보드 추천좀 부탁드립니다.. [12]	ㅇㅇ(182.215)	03.01	244	0
12837	질문	ㅇㄹ SZR KDB 상점의 corne 무선 구매하려고 하는데요. [1]	ㅇㅇ(140.248)	02.28	126	0
12836	일반	토요일 저녁의 지듣노	EasternCloud	02.28	47	0
12835	일반	키보드 추천 부탁드립니다	갈르셈단(220.71)	02.28	111	0
12834	일반	토템 플러스 알1리 [1]	갈르셈단(58.232)	02.28	145	1
12833	질문	zmk 슬립할때 왤케 잘 안깨어나지??	ㅇㅇ	02.28	82	0
12831	일반	어느 호킹을 할지 고민되네 [2]	ㅇㅇ	02.28	179	0
12830	일반	저장용 [2]	ㅇㅇ(175.204)	02.28	176	0
12829	일반	sofle 주문했는데 완전히 다른 제품 배송받음 [9]	ㅇㅇ(175.204)	02.28	166	0
12828	일반	조이스틱 두 개로 뭔가 가능하지 않을까 싶어서 급하게 실험해보는 중 [3]	하츠치리	02.28	144	0
12826	일반	아 cornix 2월초에 주문했는데 [4]	ㅇㅇ	02.28	150	0
12825	일반	요즘은 코르닉스만 쓰고있음 [6]	돈이부족한데요엣	02.28	246	0
12824	일반	겜하려고 평범한 게이밍 마우스 산 거 있는데 [1]	하츠치리	02.28	123	0
12823	일반	됐다 [6]	하츠치리	02.28	183	1
12822	일반	트랙볼 마우스 생각보다 편하네 [3]	갈르셈단(211.109)	02.28	251	0
12821	일반	너무길쭉해요 [2]	유부말이	02.28	212	0
12820	질문	vial 40 키보드 키맵 도와주세여 [3]	하얀치비	02.27	156	0
12819	질문	혹시 타임리스 홈로우 쓰고 있는 분 계신가요? [13]	갈르셈단(210.100)	02.27	172	1
12818	일반	2월 마지막 금요일의 지듣노 [4]	EasternCloud	02.27	76	0
12817	일반	사진 보내주자마자 차단 박는 거 사진만 먹고 튄 건가요? [3]	ㅇㅇ	02.27	235	0

최근 방문

즐겨찾기

즐겨찾기 갤러리

이미지 올리기 이용안내

갤러리 이슈박스, 최근방문 갤러리

연관 갤러리

미니 갤러리 소개

차단하기

[스플릿 키보드 갤러리]

갤러리 본문 영역

추천 비추천

댓글 영역

① NFT 발행

② NFT 구매

파워링크 광고

하단 갤러리 리스트 영역

왼쪽 컨텐츠 영역

갤러리 리스트 영역

페이지 이동

오른쪽 컨텐츠 영역

알림 설정

알림

디시콘 리스트

디시콘

디시콘 검색결과(0)

인기 디시콘