# NO CODE! how to use today's new chrysalis! EASY! **URL:** \ **Category:** Help and Getting Started\ **Created:** [February 6, 2019, 1:12am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498 "2019-02-06T01:12:46Z")\ **Posts on this page:** 12\ **Page:** 1
**Author:** ![fluster1](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/fluster1/32/2525_2.png) [@fluster1](https://community.keyboard.io/u/fluster1)\ **Post date:** [February 6, 2019, 1:12am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/1 "2019-02-06T01:12:46Z")
feb 5, 2019 This is kind of long because I told everything I had to learn to do what I needed to do today plus how to see the layer thing. feel free to use this any way you like, and be sure to cut it all you want! * * * How to use this simple (but not necessarily) little app called Chrysalis to fix your keyboard up exactly how you like. This is just a writer’s explanation of how to use Chrysalis for little things. First, a) Download Chrysalis [website someone], update the firmware for your keyboard here [website someone else], install Chrysalis on your computer. The websites there have good directions. b) While you are hanging around in bars and pool halls on a school night, you might as well go ahead and join Discord—I think it’s harder not to find it than it is to find it. You will need it probably sometime, and it’s nice to ask questions to people who will actually answer them even though they are the _ **Einsteins of Keyboardio!** _ If you need help with this switching of the key functions, go to #Chrysalis in discord, which is where they will tell you stuff about how to use it. c) Next, start Chrysalis up; then on the bottom left, hit scan for keyboards and on the right, choose yours. d). Hit “connect” and…. _Voilá!_ Your app will open on the default layer, which is the way _Keyboardio_ will think you are set up whenever you plug in and start up. You can change how _Keyboardio_ thinks you are set up though, which is the whole point of this little app. Now this is a follow-your-dog-down-the-street easy kind of app which you can use to assign different jobs to the keys than the ones they came with. And you can save them so when you plug in, _Keyboardio_ will remember your needs as a Crypto-Russian Keyboard Code-Builder or whatever. To use Chrysalis it seemed to me there is only one thing you kind of have to learn just a definition of and know where two of them are-- and those are “layers.” _About Layers:_ @obra explained it to me like this on Discord: Each “layer” is a layout of keys. Some, like QWERTY cover all the keys Some, like NUMPAD cover only part of the keyboard. If a layer doesn’t cover the whole keyboard, the parts underneath show through. It’s like putting those old-school rubber covers on your keyboard with different key labels printed on them, except some of the covers have holes cut out. Thank you @obra! I think what @obra means is you have some default layers (the one you get when you plug in default layer 0, and if you look at the picture, you will see a label on your function keys—mine says “Shift to 2,” so that means when I push on the function key with my palm, I get layer 2 default! You can go to layer 2 and see what it came with. I have not figured out what layer 1 or 3 are or what to do with them yet, but you probably will. For my simple needs, layer 0 and 2 (where my function keys told me to go) were plenty to entertain me and prevent me from typing on that crazy keyboard for the rest of the day. It’s already a great design, but there were just a couple of things I needed. 1. I needed the carriage return (or “enter,” for you children) _all_ the time, and can’t quite easily reach the enter key two switches away from home with my right index finger. I need a fix for that. (Turns out you can hit fn-space and get enter, as I found out on discord, but you know, I wanted a dedicated key). 2. I can’t really reach the shift key way down on the bottom of the thumb arch every time I start a new sentence, which isn’t all that often, now that I think of it. But It’s just too far. 3. Also, I think there is not a “capslock” key anywhere, perhaps to discourage yelling in writing. Generally I think that is a good idea; however, I use capslock to express horror, not to yell. well I figured out how to do this too. Now to change the keys, this is how I did it: A. So to solve problem 1, check you are on default layer 0 in Chrysalis. I decided to put the shift key to the left of bskp and to the right of space on both thumb arches. B. On the picture of the keyboard, click the key you want to change to something else. I do that, clicking the key on the top left of the left thumb arch which I want to be “shift.” Then at the bottom of the window on the left you see “key type”—“shift” is a punctuation key (go ahead, click on the little triangle and scroll through the key types!). I clicked “Punctuation.” Oh no. Well, that was wrong. Perhaps “Shift” is another kind of key—maybe it’s a modifier? Oh yeah, there it is under “modifiers.” I guess all those keys on the thumb arch are modifiers. Ok. C. So I find “Lshift” (left shift) in the modifier key set and click on it. I already clicked where I wanted the Lshift to be and it is outlined in red. Kinda nice with the picture. D (for DONE) Now on the picture on my screen, the key to the left of backspace says Lshift. Then you hit the little circle thing on the bottom right to save it and hit the little circle thing (don’t forget) on bottom right and _Voici_ Now eat the ice cream, get another bowl, and repeat to change the other little things on layer 0 that I or you want to change. E. Now get this: With a paper clip (be careful not to scratch the little darlings), you can lift up the thumb keys (but only the thumb keys because all the others have unique shapes) and switch them around! So I moved the “shift” mechanical key to where I had put it electronically and moved the ctrl key to the bottom of the left thumb arch. Perfect! I also wanted an enter key I could reach in spite of the handy fn-space carriage return trick, and there are two keys that have no assigned job yet, the “butterfly” and “any.” I used the butterfly to be my enter key, still on layer 0. Just like before. Follow the dog. This is a fabulous space for enter if you ask me. And that is all for the poet’s keyboard. Also, please note that _Fn-space_ is a carriage return if this is too much trouble. * * * for more fun and games, I did decide I liked the music control thing—being able to adjust the tunes with my keyboard which I have never actually done on my mac which does NOT have a groovin’ keyboard. Since those music commands are rightly “functions” and my picture says the function layer is on layer 2 (right ON the function keys in the layer 0 picture), I go to layer 2 default, and start choosing how I want to do my music. I don’t know why I changed it; I am sure it was perfect already, but it gets pretty fun while you work with Chrysalis, and anything beats the frustration of day 2 of typing with the new keyboard—(I’ll get it though and be able to write ten times more stories without carpal tunnel syndrome than I’ve been able to write. Plus now that they refuse to give you pain meds in the recovery room anymore lest you become addicted to surgery CPT repair surgery is simply _out._ Thanks _Keyboardio!_ Back to the music, I decided I would never use “pg up” and “pg down,” and I assigned them volume up and down. And sure enough, it worked! I put it on layer 0 because I’ll never use the page keys. If you do use page up and page down, you could put the volume on them in layer 2 default so you would just hit the palm fn key with page up and page down just the volume of _Meddle_ when your boss calls you. It’s already set up to do that somewhere else but I can’t remember where and I need that volume down all the time. When you want to assign music functions, you go to “media keys” on the left under the picture in order to find them. I still don’t have a good solution for CAPS LOCK, but I know for darn sure I will never use Numlock as long as I _want_ to live, so although I changed Numlock to Delete in layer 0, I can still have it be Capslock on the function layer. Chrysalis is now easy, and it’s fun and I freaking love this keyboard though I avoid it like the plague after my fifteen minutes (today), but 20 tomorrow! Thanks Jesse and Kaia. –@jen 1 ---
**Author:** ![\_rkstar](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/_rkstar/32/539_2.png) [@\_rkstar](https://community.keyboard.io/u/_rkstar)\ **Post date:** [February 13, 2019, 4:05pm UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/2 "2019-02-13T16:05:08Z")
so i just updated my firmware with chrysalis but my LAYER 0 is locked and i can’t edit it. i just want to switch the shift keys with the gui/alt keys! i tried copying it to layer 3 and setting that as my default, but a lot of weirdness happened. what am i doing wrong? [edit] **solved:** i copied layer 0 to layer 3, modified what i wanted, then went into settings and turned off the **locked** layers, only use **custom** layers, and set my default layer to (what is the new) LAYER 0. woot. back to normal! ---
**Author:** ![jesse](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/jesse/32/361_2.png) [@jesse](https://community.keyboard.io/u/jesse)\ **Post date:** [February 13, 2019, 10:03pm UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/3 "2019-02-13T22:03:35Z")
I’m glad you got it sorted. For folks starting from 0.40 and newer, that -ought- to be done automatically. ---
**Author:** ![TheEvilSloth](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/theevilsloth/32/2128_2.png) [@TheEvilSloth](https://community.keyboard.io/u/TheEvilSloth)\ **Post date:** [March 12, 2019, 4:08am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/4 "2019-03-12T04:08:03Z")
Has this issue returned in 0.50? I’m seeing it there at least (on ubuntu 18.10, fwiw) ---
**Author:** ![polsonst](https://avatars.discourse-cdn.com/v4/letter/p/a587f6/32.png) [@polsonst](https://community.keyboard.io/u/polsonst)\ **Post date:** [March 12, 2019, 12:58pm UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/5 "2019-03-12T12:58:47Z")
By the time Chrysalis 1.0 is released, I’ll adopt it for all my keyboards and never actually use it again because by then I’ll be totally satisfied with my layouts and won’t want to fiddle with ithem anymore. 😉 I still want to translate my keyboards to Chrysalis though, just because it will be fun to do. ---
**Author:** ![Sean](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/sean/32/524_2.png) [@Sean](https://community.keyboard.io/u/Sean)\ **Post date:** [March 14, 2019, 5:40pm UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/6 "2019-03-14T17:40:43Z")
If someone can build a Windows/AA64 version, I can test that… The x86 version won’t run on my work machine. ---
**Author:** ![algernon](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/algernon/32/4404_2.png) [@algernon](https://community.keyboard.io/u/algernon)\ **Post date:** [March 14, 2019, 6:32pm UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/7 "2019-03-14T18:32:21Z")
Sadly AA64 is not a supported platform by Electron ☹ ---
**Author:** ![Sean](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/sean/32/524_2.png) [@Sean](https://community.keyboard.io/u/Sean)\ **Post date:** [March 15, 2019, 8:35am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/8 "2019-03-15T08:35:05Z")
Fair. That does seem to be blocking quite a lot of ports at the moment. ---
**Author:** ![chrisSCM](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/chrisscm/32/907_2.png) [@chrisSCM](https://community.keyboard.io/u/chrisSCM)\ **Post date:** [November 28, 2022, 1:54pm UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/9 "2022-11-28T13:54:57Z")
This is the first post that came up when searching “Chrysalis”, so I’ll put [the link](https://github.com/keyboardio/Kaleidoscope/wiki/Installing-Chrysalis) here. ---
**Author:** ![BettyT](https://avatars.discourse-cdn.com/v4/letter/b/35a633/32.png) [@BettyT](https://community.keyboard.io/u/BettyT)\ **Post date:** [December 2, 2022, 1:20am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/10 "2022-12-02T01:20:02Z")
Just want to drop you a thank you note Jennifer for your detailed post. I just received my model 100 and being a non-tech person, I was at a complete loss at how to use Chrysalis without the typical hand-holding manual material. Now it’s all set up, I love it! THANK YOU! ---
**Author:** ![fluster1](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/fluster1/32/2525_2.png) [@fluster1](https://community.keyboard.io/u/fluster1)\ **Post date:** [December 2, 2022, 3:27am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/11 "2022-12-02T03:27:07Z")
I cannot even believe. I ever figured that out or understood it. My keyboard it has been in storage sadly and … I wish I had been able to use it wo all this pain! I’m Glad you understood it! It is a poet’s set up though! Thanks for your kind words and thanks for your fab invention Jesse and Kaia. I would Pau for someone To just set it up for ne If it needs it again so I can just use it! Jesse what ought to be done automatically? ---
**Author:** ![jesse](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/jesse/32/361_2.png) [@jesse](https://community.keyboard.io/u/jesse)\ **Post date:** [December 2, 2022, 5:41am UTC](https://community.keyboard.io/t/no-code-how-to-use-todays-new-chrysalis-easy/2498/12 "2022-12-02T05:41:43Z")
Hi Jennifer, Please feel free to drop us a note at [help@keyboard.io](mailto:help@keyboard.io) and we’d be happy to help you get set up if you ever need more setup help. -jesse